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The present invention relates to the presentation of 
multimedia content, and more particularly to the presentation 
of locally stored media content combined with remote 
interactively-obtained network media content. 

BACKGROUND OF THE INVENTION 

In marketing, many things have been long recognized 
as aiding success, such as increasing customer satisfaction 
through such devices as providing personalized service, fast 
service, access to related or updated information, etc. 
Traditional marketing has made use such things as notice of 
promotional offers for related products such as providing 
coupons, etc. Additionally, some studies have shown that 
simple repeated brand exposure, such as by advertisement, 
increases recognition and sales. 

One of the largest marketing industries today is the 
entertainment industry and related industries. To date, 
digital versatile disks (DVDs) are poised to encompass 
consumer sales of home entertainment, business and home 
computer industry, and business information market with a 
single digital format, eventually replacing audio CDs, 
videotapes, laserdiscs, CD-ROMs, and video game cartridges. 
To this end, DVD has widespread support from all major 
electronics companies, all major computer hardware companies, 
and all major movie and music studios. 

Currently, the fastest growing marketing and 
informational access avenue is the Internet. The share of 
households with Internet access in the U.S. soared by 58% in 
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two years, rising from 26.2% in December 1998 to 41.5% in 
August 2000 (Source: Falling Through the Net: Toward Digital 
Inclusion® by the National Telecommunications and Information 
Administration, October 2000) . 

Some initial efforts have been made to integrate the 
success of optical disks, such as the DVD, with the speed. and 
accessibility of the Internet. Programs such as music players 
currently are able to access the internet to obtain artist 
information, order music, etc. for inserted disks. However, 
in the DVD-video arena, little has been done to utilize the 
vast power for up-to-date, new, and promotional information 
accessibility to further the aims of improving marketability 
and customer satisfaction. 

Accordingly, it is evident that improvements are 
possible in the way that entertainment, computing, and 
academic disks have been supported. 

SUMMARY OF THE INVENTION 

The present invention advantageously addresses the 
needs mentioned previously as well as other needs by providing 
an application programming interface that facilitates the 
access and use of related or updated web content to provide 
augmented or improved content with playback of DVD content. 

In one embodiment, the invention can be 
characterized as an integrated system for combining web 
content and disk content comprising: a display; a computing 
device operably coupled to a removable media, a network and 
the display, the computing device at least once accessing data 
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on the network, the computing device comprising: a storage 
device, a browser having a presentation engine displaying 
content on the display, an application programming interface 
residing in the storage device, a decoder at least 
5 occasionally processing content received from the removable 
media and producing media content substantially suitable for 
display on the display, and a navigator coupled to the decoder 
and the application programming interface, the navigator 
facilitating user or network-originated control of the 
10 playback of the removable media, the computing device 

receiving network content from the network and combining the 
network content with the media content, the presentation 

U engine displaying the combined network content and media 

t p content on the display. 

W 15 

s iT; 
; 

%4 In another embodiment, the invention can be 

rl characterized as a method comprising: a) receiving a removable 

3; media; b) checking if said removable media supports media 

source integration; c) checking if said removable media source 

fU 20 is a DVD responsive to said removable media supporting source 

J: ik 

j*3 integration; d) checking whether said device is in a movie 

M mode or a system mode responsive to said removable media being 

a DVD; e) launching standard playback and thereafter returning 
to said step (a) responsive to said device being in said movie 
25 mode; f) checking if said device has a default player mode of 
source integration when said device is in said system mode; g) 
launching standard playback and thereafter returning to said 
step (a) responsive to said device not having a default player 
mode of source integration; h) checking if said removable 
30 media contains a device-specific executable program when said 
device having a default player mode of source integration; i) 
executing said device-specific executable program when said 
device has said device-specific executable program and 
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thereafter returning to said step (a); j) checking whether 
said device has a connection to a remote media source; k) 
launching a default file from said removable media when said 
device does not have a remote media source connection and 
thereafter returning to said step (a) ; 1) checking whether 
said remote media source has content relevant to said 
removable media; m) displaying said relevant content when said 
relevant content exists and thereafter returning to said step 
(a) ; n) otherwise launching a default file from said removable 
media and thereafter returning to said step (a) ; o) returning 
to said step (f ) . 



BRIEF DESCRIPTION OF THE DRAWINGS 

FIG. 1 shows a general example of a display device 
receiving content from local and offsite sources according to 
one embodiment. 

FIG. 2 shows a general example of a computer 
receiving content from local and offsite sources according to 
one embodiment . 

FIG. 3 shows a general example of a television set- 
top box receiving content from local and offsite sources and 
according to one embodiment. 

FIG. 4 shows a diagram showing the interaction 
between an embedded web browser and a media subsystem 
according to one embodiment. 



FIG. 5 shows an example of media and other content 
integration according to one embodiment. 
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FIG. 6 shows a general overview of the interaction 
of the components of a DVD device according to one embodiment. 

FIG. 7 shows one exemplary method for handling disk 
insertion according to one embodiment resulting in the 
launching of various contents or the display of a logo 
depending on the outcome of multiple determinations. 

FIG. 8 shows a media disk directory structure 
according to one embodiment . 

FIGS. 9-10 show 2 parts of one exemplary algorithm 
900 for handling disk insertion according to one embodiment 
resulting in the launching of different contents depending on 
disk determinations. 

FIG. 11 shows a general exemplary diagram of 
synchronous viewing of content according to one embodiment. 

FIG. 12 shows a depiction of user interaction using 
a remote control. 

FIG. 13 shows a remote control according to an 
embodiment of the present invention. 

FIG. 14 shows an example of a computer to Internet 
connection according to one embodiment. 

FIG. 15 shows an example of a bookmark according to 
one embodiment . 
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DETAILED DESCRIPTION OP THE DRAWINGS 



The following non-patent documents are hereby- 
incorporated by reference as if set forth in their entirety: 
InterActual API Design Guidelines for Consumer Electronics 
Manufacturers; InterActual Application programming interface 
(API) Specification (also called InterActual API 
Specification) 

An application programming interface (API) of the 
present embodiment is based on a scripting model, leveraging, 
e.g., industry standard HTML and JavaScript standards for 
integrating locally stored media content and remote 
interactively-obtained network media content, e.g., video 
content on a web page. The application programming interface 
(API) enables embedding, e.g., video content in web pages and 
can display the video in full screen or sub window format. 
Commands can be executed to control the playback, search, and 
overall navigation through the embedded content. 

Additionally, the application programming interface 
can be queried and/or set by the use of properties. Effects 
may be applied to playback. Video sequences have an 
associated time element during playback, and events are 
triggered to provide notification of various playback 
conditions, such as time changes, title changes, and user 
operation (UOP) changes. Events can be used for use in 
scripting and synchronizing video with HTML or read only 
memory (ROM) -based content . 

A goal of the application programming interface 
(API) is to enable content developers to create products that 
seamlessly combine, e.g., the Internet with content from other 
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digital versatile disk-read only memory (DVD-ROM) , digital 
versatile disk-audio (DVD-Audio) , and compact disc-audio (CD- 
Audio) . Hereinafter, by the use of DVD-Video, it is to be 
understood that all three of these disk/disc media are 
5 included. The combination of the Internet with DVD-Video 
creates a richer, more interactive, and personalized 
entertainment experience for users. 

Further, the application programming interface (API) 
10 provides a common programming interface allowing playback of 
this combined content on multiple playback platforms 
simultaneously. While the application programming interface 
*5 (API) allows customized content and functions tailored for 

Vox 

V0 specific platforms, the primary benefit of the application 

15 programming interface (API) is that content developers can 

■''H create content once for multi-platform playback, without the 

U I 

|H need of becoming an expert programmer on specific platforms, 

such as Windows, Macintosh, and other platforms. The document 

m InterActual Usage Guide for Developers (hereby incorporated by 

j*f 20 reference) describes this in more detail for DVD content 

p developers . 

f-sps 

Internet connectivity is not a requirement for the 
use of the application programming interface (API) . Stand - 

25 alone systems with web browser functionality are all that is 

required. In addition, compact disc-digital audio (CD-DA) can 
also be enhanced by use of the application programming 
interface (API) . This is also described in the document 
InterActual Usage Guide for Developers (hereby incorporated by 

3 0 reference) . 

Personal video recorders (PVRs) , such as the TiVo, 
RePlay, and digital versatile disk-recordable (DVD-R) devices, 
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enable the ability to purchase video or audio products by 
downloading them from a satellite or other high-bandwidth 
system when implemented with the present invention. When so 
downloaded, the video or audio can be stored to a local disk 
5 system or burned onto a DVD-R. 

The application programming interface (API) provides 
a basic set of guidelines for the production of internet- 
connected DVDs and for the playback of these enhanced DVDs on 
10 a range of computer, set-top platforms, and players. Based on 
the industry standard publishing format hypertext markup 
language (HTML) and JavaScript, the application programming 
interface (API) provides a way to easily combine DVD-Video, 
DVD-Audio, and CD-Audio with and within HTML pages, whereby 
15 HTML pages can control the medians playback. The application 
programming interface (API) provides a foundation for bringing 
content developers, consumer electronics manufacturers, 
3 „. browser manufacturers, and semiconductor manufacturers 



hi I 



|6 together to provide common development and playback platforms 

;*? 20 for enhanced DVD content. 

p 

Regarding FIG . 1, shown is a general example of a 
display device receiving content from local and offsite 
sources according to one embodiment . 

25 

Shown are a display device (102) , a local content 
source (104) , and an offsite content source (106) . 

The display device (102) is coupled to the local 
30 content source (104) as shown by a bi-directional arrow. The 
display device (102) is coupled to the offsite content source 
(106) as shown by a bi-directional arrow. 
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In operation, the display device (102) displays 
video and/or hypertext markup language (HTML) documents to a 
user. In an alternative embodiment, the display device (102) 
can be audio only. Display device (102) can be any device 
5 capable of displaying an external video feed or playing an 

external audio feed such as, but not limited to, a computer, a 
set top box, gaming platforms, or a player. The display 
device (102) receives content for display from either the 
local content source (104) or the off site content source 
10 (106) . The local content source (104) , in one embodiment, can 
be any device capable of playing any media disk including, but 
not limited to, digital versatile disks (DVDs) , digital 
^ versatile disk read only memories (DVD-ROMs) , compact discs 

(CDs) , compact disc-digital audios (CD-DAs) , optical digital 
f'Jj 15 versatile disks (optical DVDs), laser disks, DATAPLAY (TM) , 
■-J streaming media, PVM (Power to .Communicate), etc. The 

m off site content source (106) , in one embodiment, can be any 

s device capable of supplying web content or HTML- encoded 

|S content such as, but not limited to, a network-connected 

iu 20 server or any source on the Internet. 

|& 

if ; ~f; 

fR3 ' FIG. 2 shows a general example of a computer 

receiving content from local and offsite sources according to 
one embodiment . 

25 

Shown are a local content source (104) , an offsite 
content source (106) , a computer (202) , a microprocessor 
(204) , and a memory (206) . 

3 0 The local content source (104) is coupled to the 

computer (202) . The offsite content source (106) is coupled 
to the computer (202) . The computer (202) includes the 
microprocessor (204) and the memory (206) . 
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In operation, computer (202) is any computer able to 
play/display both video or audio provided by the local content 
source (104) and/or web or HTML content as provided by the 
offsite content source (106) . Additionally, computer (202) 
can display both video and web/ HTML content synchronously 
according to one embodiment of the present invention. 
Microprocessor (204) and memory (206) are used by computer 
(202) in executing software of the present invention. 

FIG. 3 shows an example of a general system 300 
comprising a television set-top box receiving content from 
local and offsite sources and according to one embodiment. 

Shown are a local content source (104) , an offsite 
content source (106), a set-top box (302), a microprocessor 
(304) , a memory (306) , and a television (308) . 

In operation, set-top box (302) enables selection 
between video or audio provided by the local content source 
(104) and web or HTML content as provided by the offsite 
content source (106) . The set-top box (302) provides selected 
content to television (308) for display. Additionally, set- 
top box (302) can combine both video and web/HTML content 
synchronously according to one embodiment of the present 
invention and provide the same to television (308) for 
display. Microprocessor (304) and memory (306) are used by 
computer (202) in executing software of the present invention. 

Referring to FIG. 4, shown is a diagram showing the 
interaction between an embedded web browser and a media 
subsystem according to one embodiment . 
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Shown are a hardware platform (402) , an embedded web 
browser (410) , and a media subsystem (420) . 

The hardware platform (402) executes both the 
embedded web browser (410) and the media subsystem (420) . The 
embedded web browser (410) is coupled to the media subsystem 
(424) . The media subsystem (420) is a superset of media 
services including DVD navigator for DVD disc. The media 
services is discussed in greater detail in relation to FIG. 6 
later herein. When the media is not disc oriented, the media 
navigation is carried out by another component. 

In operation, the hardware platform (402) has 
microprocessor or other processing circuitry (as shown in 
FIGS. 2-3) executing both the embedded web browser (410) and 
the media subsystem (420) . The hardware platform (402) can be 
any device suitable for the present invention such as, but not 
limited to, television set- top boxes, DVD players, computers, 
etc . 

The application programming interface (API) 
provides a common programming interface for hypertext markup 
language (HTML) and ECMAScript (a standardized script based on 
JavaScript and the like) for ensuring playback of enhanced 
content on multiple playback platforms. Internet connectivity 
is not required for the use of the application programming 
interface (API) when content originates from disk ROM. 

The application programming interface (API) 
facilitates the playback of audio and/or video embedded within 
a web page. The application programming interface (API) can 
play back full-screen video or video within a web page window 
(sub window) . Audio and/or video is embedded within a HTML- 
encoded page by use of an appropriate tag such as, but not 
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limited to, the object tag (for the Microsoft Windows 
operating system) and the embed tag (for the Apple Macintosh 
Liberate operating system) . 



5 Table 4 Examples of embedding DVD-Video in HTML 





Oneratina 


Example 




Svsfcem 






Microsoft 


<rOBJECT classid=clsid:E358A3BE-6E9A-4BD4- 




W lllUOWb 


93FB-F95FAA72FC01 height=140 






id=InterActual style="HEIGHT : 189px; 


U K 

Tsar 




WIDTH: 320px" width=160> 


ly 




</OBJECT> 


y ? 

' 7s 
5 H 


Apple 


<embed TYPE= 1 application/x-itx-plugin ! 


jf^ 
%f * 


Macintosh 


HIDDEN= 1 true ' name= ' InterActual 1 




Liberate 


ALIGN-center HEIGHT=100 WIDTH=200 






CODEBASE= ' ITXClasses .jar' TitleSleep-10000 






ChapterSleep=10000 TimeSleep=10000 




PropertySleep=10000 MAYSCRIPT> 






</embed> 




Linux 


TBD 




Others 


TBD 



Optionally, on players that support the ATVEF 
standard, the object could be referenced in the following 
manner : 

10 

<object data="tv:" height =x width=x> 
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After the DVD-Video object is embedded in the web 



page, it can be accessed using any style sheet, link, or 
scripting language. Values for the ID string must begin with a 
5 letter (A-Z or a-z) and may be followed by any number of 

letters, digits, hyphens, and periods up to a maximum of 48. 



have a full-featured operating system and browser. Therefore, 
10 the capabilities within the browser are often more restricted. 
For embedding DVD-Video within these platforms using the 
application programming interface (API) , the "InterActual" 
indentifier (ID) must be integrated within the embedded 
browser as any other tag structure. The ID allows the API to 



t\ 15 be associated with the HTML object. With this approach, any 
iH embedded browser that encounters the "InterActual" tag would 

automatically associate this identifier with the application 
15 programming interface (API) . 



level of Wwindow handling: 

- Toggling between full screen presentation of HTML 
and full screen video 



Unlike computers, set -top boxes do not generally 




The embedding of the video object assumes a certain 



25 



- Displaying DVD-Video within an HTML frame/window 

- Dynamic resizing of the video window size 



30 



Note: The application programming 
interface (API) will play video full screen down to 
a 4:1 downscale (180 x 120 for NTSC and 180 x 144 



for PAL) . 
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The application programming interface (API) provides 
interaction with hardware platform (402) by means of commands 
(or methods), properties, and events. Commands (also called 
methods) are executed to control the playback of, search of, 
and navigation through video and/or audio content. The 
environment can be queried to ascertain the status of various 
properties. Events are triggered by the occurrence of various 
operating or playback conditions and serve to provide 
notification of these playback conditions. Events are 
essential for scripting and the simultaneous presentation of 
the media content (audio and/or video) with other web assets 
(such as text, graphics, etc.). Thus, properties are passive 
(provided in response to queries) and events are active 
(provided without queries) . 

Commands 

Commands such as InterActual . PlayTitle, allows the 
HTML content to control playback of the media. Commands are 
parsed by the browser presentation engine (described later in 
greater detail in reference to FIG. 6) and then passed to the 
DVD navigator (described later in greater detail in reference 
to FIG. 6) to effect playback. 



Properties 

Properties allow the HTML content to query for state 
information of the DVD navigator. An example includes 
InterActual. TitleNumber. Properties are parsed by the 
presentation engine and passed thereafter to the DVD 
navigator. In response, the DVD navigator interprets the 
query and returns the requested information. 



Events 

Events allow the HTML content to receive state 
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information from the DVD navigator. An example of an event 
notification would be InterActual . TitleEvent . Events are 
propagated from the DVD navigator to the browser presentation 
engine whenever the requested state changers. The HTML 
content can subscribe to events using any of the event 
handlers as described in the application programming interface 
(API) specification. 

FIG. 5 shows an example of media and other content 
integration according to one embodiment. 

Shown are a display device (502), a screen (504), a 
content area (505) , and a sub window (508) . 

The display device (502) contains the screen (504) 
able to display graphics and text. The content area (506) 
contains the sub window (508) (also referred to as a video 
window or alternate frame) . 

An important aspect of this embodiment is that audio 
and/or video can be integrated with other content such as text 
and/or graphics described in web compatible format (although 
the source need not be the Internet, but can be any source 
such as a disk or server able to deliver this content) . 

As an example, the sub window (508) displays movie 
content, such as the movie T2, and the content area (506) 
displays text and/or graphics (provided by HTML coding) which 
is topically related to the part of the movie playing in the 
sub window (508) . When the user /viewer interacts with the 
content in the content area (506) , such as by clicking on a 
displayed button, effects will be reflected in the media sub 
window (508) . As an example, clicking on buttons or hypertext 
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links indicating sections or particular points in the movie 
results in the video playback jumping to the selected point. 
Additionally, the media displayed in sub window (508) can 
result in changes in the content area (506) . As an example, 
progression of the movie to a new scene results in a new text 
display giving information about the scene. 

Concurrent browsing and video playback 
A primary feature of the application programming 
interface (API) is the ability to view HTML pages while 
playing video and/or audio content. The concurrent playback 
of browser and video places additional requirements on the 
processing power and memory of the underlying hardware. Each 
DVD semiconductor solution should be designed to perform both 
of these functions simultaneously. A required feature of the 
application programming interface (API) is the ability to 
display downscaled video within a frame of a web page. 
Additionally, video upscale is another feature of an 
embodiment as HTML content is already being designed with the 
assumption that this capability will be available in future 
devices . 

Storyboard with scrolling display 
As example of one embodiment is a movie authored 
with the entire screenplay provided on the DVD disk in HTML 
format. When a viewer clicks on any screen visually 
represented in HTML, the system links the viewer to that scene 
(by use of the command InterActual . SearchTime to go to the 
specific location within a title) within the DVD-Video. 
Besides being capable of a finer granularity than the normal 
chapter navigation provided on DVD-Video, the HTML-based 
script can contain other media such as a picture (by use of 
the command "InterActual .Displaylmage") or special audio (by 
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use of the command "InterActual .SelectAudio") and/or live 
links for other information. Further, the text of the 
screenplay in HTML could automatically Ascroll® with the DVD- 
Video to give the appearance of being synchronized with the 
DVD-Video. Although many of these types of features can be 
authored in DVD-Video (except, of course, live web links and 
synchronized scrolling) , HTML authoring is much more 
efficient, immediate, and widely known. 

FIG. 6 shows a general overview of the interaction 
of the components of a DVD device according to one embodiment . 

Shown are a DVD device (602) , an embedded web 
browser (410) , a presentation engine (612) , a web browser 
application programming interface for media services (614) , 
DVD hardware (620) , a DVD navigator (622) , a media services 
(628), a DVD decoder (626), and an internet (630). 

The DVD device (602) includes both the embedded web 
browser (410) and the DVD hardware (620) . The embedded web 
browser (410) includes the presentation engine (612) . The 
embedded web browser (410) is coupled to the web browser 
application programming interface for media services (614) 
which, in turn, is coupled to the DVD hardware (620) . The DVD 
hardware (620) includes the DVD navigator (622) and the DVD 
decoder (626) . The DVD navigator (622) includes the media 
services (628) . The media services (628) is coupled to the 
DVD decoder (626) . The DVD device (602) is coupled to the 
internet (630) . The media services (628) corresponds to the 
media subsystem (628) but has a more specific implementation. 
The media subsystem (628) is a superset of the media services 
(628) and includes DVD navigator for DVD disc. 
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With the DVD device (602), the user is able to 
interact with an enhanced DVD on a television in the same 
fashion as can be experienced on a computer. The display area 
of a television can show video and HTML content concurrently. 
This is accomplished by the embedded web browser (410) in the 
DVD player. As discussed herein in reference to FIG. 4, the 
HTML content can control the playback of the video through 
embedded application programming interface (API) commands. 

The embedded web browser (410) is responsible for 
displaying the HTML content authored on interActual -compatible 
disks, stored locally on device (602), or served from a remote 
server location. The embedded web browser (410) also supports 
concurrent playback of video and audio while presenting the 
HTML page. 

Presentation Engine 

The presentation engine (612) of the browser must 
provide for the embedding of video within web pages. 
Embedding video within web pages defines the location where 
the video is played. This location information is then parsed 
by the presentation engine and passed to the underlying video 
rendering engine. 

The presentation engine (612) of the embedded web 
browser (410) parses the HTML instructions for controlling the 
media playback, generates any graphic portions of the display, 
positions a video window when it exists, and also interfaces 
directly with the underlying DVD Navigator. InterActual- 
specific instructions are interpreted by the presentation 
engine (612) and passed to a DVD abstraction layer, which can 
be part of the embedded browser or developed by the DVD 
navigator manufacturer. This layer serves as an abstraction 
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that makes it possible to map the browser into a DVD player- 
specific DVD navigator developed either by the semiconductor 
manufacturer or the player manufacturer. Of course, the DVD 
Navigator interfaces with the underlying video and audio 
5 decoders . 

DVD Navigator abstraction layer 

The web browser application programming interface 
for media services (614) (or DVD navigator abstraction layer 
10 (614) ) is a very thin interface layer between the presentation 
engine (612) and the media services (628) . 

The DVD Navigator abstraction layer (614) may be 
developed by the player manufacturer or the semiconductor 

15 manufacturer. To support a flexible and portable solution, 
the DVD navigator abstraction layer (614) is recommended to 
reside in between the browser (410) and the DVD navigator 
(622) . Abstracting the communication between the browser 
(410) and navigator (622) offers a more robust and portable 

20 design, so that either the browser or the navigator can be 
changed in future player designs. 

The DVD navigator (622) controls the decoding and 
playback of media in the drive. 

25 The media services (628) serves as a middleware 

layer between web browser application programming interface 
for media services (614) and the DVD navigator (622) . The 
media services (628) facilitates content running in the 
embedded web browser (410) to control the DVD navigator (622) . 

30 The media services (628) allows the DVD navigator (622) to 
work with any web browser compliant with the present 
embodiment . 
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The DVD decoder (626) interfaces between the DVD 
media interface hardware contained in the DVD hardware (620) 
and the DVD navigator (622) . 



5 The Internet (630) is shown as a specific example of 

the off site content source (106) shown in FIGS. 1-3. 

Referring to FIG. 7, shown are the details for the 
web browser application programming interface for media 
10 services (414) of FIG. 4. 

Shown are an embedded web browser (410) , a command 

I'JS handler (with command API) (702) , a properties handler (with 

w properties API) (704) , an event generator (with event API) 

|f| 15 (706) , a cookie manager (with cookie API) (708) , an identifier 

^ engine (710), an initialization module (712), a navigator 

111 

|fi state module (714) , a bookmark manager (716) , a system 

;L resources (720) , a system timer (722) , a system monitor (724) , 

10 a system initialization (726) a DVD/CD navigator (422) , a user 

It 20 remote control (730) , a front panel display module (732) , a CD 
p decoder (734) , a DVD decoder (426) , an I/O controller (736) , a 

disk (738) , a HTML/ JavaScript content (740) , and an 

InterActual API (742) . 

25 The embedded web browser (410) is coupled to the 

command handler (which has an associated command API) (702) as 
shown by a bi-directional arrow. The embedded web browser 
(410) is coupled separately to the properties handler (which 
has an associated properties API) (704) , the event generator 

30 (which has an associated event API) (706), and the cookie 

manager (which has an associated cookie API) (708) , all three 
connections shown by an arrow pointing towards the embedded 
web browser (410) . 
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The command handler (702) is coupled to the bookmark 
manager (716) shown by a bi-directional arrow. The command 
handler (702) is coupled to the DVD /CD navigator (422) shown 
by a bi-directional arrow. The command handler (702) is 
coupled to the navigator state module (714) shown by a bi- 
directional arrow. The command handler (702) is coupled to 
the system resources (720) by an arrow pointing to the system 
resources (720) . 

The properties handler (704) is coupled separately 
to the bookmark manager (716) and the identifier engine (710), 
both shown by an arrow pointing to the properties handler 
(704) . The properties handler (704) is coupled the event 
generator (706) by a bi-directional arrow. 

The event generator (706) is coupled to the 
navigator state module (714) shown by a bi-directional arrow. 
The event generator (706) is coupled to the system timer (722) 
shown by an arrow pointing to the event generator (706) . The 
event generator (706) is coupled to the cookie manager (708) 
by an arrow pointing to the cookie manager (708) . 

The cookie manager (708) is coupled to the 
identifier engine (710) shown by a bi-directional arrow. 

The identifier engine (710) is coupled to the I/O 
controller (736) by an arrow pointing towards the identifier 
engine (710) and to the navigator state module (714) by a bi- 
directional arrow. 

The initialization module (712) is coupled to the 
system initialization (726) by an arrow pointing towards the 
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initialization module (712) . The initialization module (712) 
is coupled to the navigator state module (714) by an arrow 
pointing to the navigator state module (714) . 

The navigator state module (714) is also coupled 
separately to the bookmark manager (716) and the DVD/CD 
navigator (422) by bi-directional arrows. 

The DVD/CD navigator (422) is coupled to the user 
remote control (730) by an arrow pointing to the DVD /CD 
navigator (422) . The DVD/CD navigator (422) is coupled to the 
front panel display module (732) by an arrow pointing to the 
front panel display module (732) . The DVD/CD navigator (422) 
is coupled to the DVD decoder (426) by a bi-directional arrow. 

The I/O controller (736) is coupled separately to 
both the DVD decoder (426) and the CD decoder (734) by arrows 
pointing away from the I/O controller (736) . The I/O 
controller (736) is coupled to the disk (738) by an arrow 
pointing to the disk (738) . 

The disk (73 8) is coupled to the HTML/ JavaScript 
content (740) by an arrow pointing to the HTML/ JavaScript 
content (740) . 

The HTML/ JavaScript content (740) is coupled to the 
Application programming interface (API) (742) by an arrow 
pointing to the Application programming interface (API) (742) . 

In operation, the embedded web browser (410) 
receives HTML / JavaScript content from disk (73 8) which is 
displayed by presentation engine (612) . The embedded web 
browser (410) originates commands (as a result of user 
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interaction which can be via the remote in set- top systems, 
the keyboard or mouse in computing systems, the game interface 
in gaming systems, etc.), which are sent to the command 
handler (702) by way of the command API • The embedded web 
browser (410) also receives commands from the command handler 
(702) by way of the command API. An example of such a command 
is InterActual . Fullscreen (w) . The embedded web browser (410) 
also receives cookies from the cookie manager (708) via the 
cookie API, generally in response to the accessing of an 
Internet website. The embedded web browser (410) also 
receives events (notifications) each of which is a 
notification that a respective defined event (generally 
related to media playback) has occurred. These events are 
generated by the event generator (706) and sent via the event 
API. The embedded web browser (410) also queries properties 
from the properties handler (704) via the properties API. 
Properties are received in response to inquiries generated by 
the embedded web browser (410) . 

The command handler (702) controls the DVD/CD 
navigator (422) including starting and stopping playback, 
changing audio streams, and displaying sub-pictures from 
JavaScript, among many things. The command handler (702) 
provides live web content for non-InterActive disks when an 
active Internet connection is present through such commands as 
InterActual • NetConnect {) and InterActual .NetDisconnect () . The 
command handler (702) commands the bookmark manager (716) 
through such commands as InterActual . GotoBookmark () and 
InterActual . SaveBookmark ( ) . The command handler (702) also 
interacts with the navigator state module (714) generally 
regarding user interaction. The Navigator state module (714) 
keeps the current state of the system and receives it directly 
from the decoder (or maps directly into it) . When the 
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bookmark manager (716) is going to save a bookmark and needs 
to know the current title, the bookmark manager (716) receives 
it from the navigator state module (714) and places it in a 
bookmark and returns it to the command handler to allow it to 
5 provide a return value to the InterActual . SaveBookmark 
command ♦ 



The properties handler (704) provides the embedded 
web browser (410) with the ability to interrogate the 
10 navigator state module (714) for the DVD/CD navigator (422) 
state which includes the properties (also referred to as 
attributes) of the elapsed time of the current title, the disk 
\Q type, and the disk region, among others. The properties 

1.0 

|y handler (704) maintains knowledge of system attributes. The 

f: 15 Event Generator monitors these attributes and triggers and 
||1 event when one is changed. 

m 

13 The event generator (706) provides notification to 

l£ the DVD/ CD navigator (422) of events such as a change of title 

s y 

M 20 or chapter with web content (based on DVD time codes and the 

system time from the system timer (722)). The event generator 
(706) notifies the properties handler (704) of event 
triggerings which are of interest to the properties handler 
(704) , The event generator (706) also provides events to the 
25 cookie manager (708) such as relate to the accessing of web 
pages, disk insertion, and disk ejection events. 



m 

■SKR7 



The cookie manager (708) interacts with the 
identifier engine (710) to provide the ability to save 
30 information regarding the disk, platform, current user, and 
the application programming interface (API) version in local 
storage . 
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The identifier engine (710) provides the ability to 
generate a unique identifier for the media which enables the 
DVD ROM content (HTML and JavaScript from the disk) to carry 
out platform validation to ensure a certified device is 
5 present. The identifier engine (710) provides the ability to 
serialize each disk by reading and processing the information 
coded in the burst code area (BCA) of the disk. The BCA is 
read by the identifier engine (710) and stored in the 
navigator state module (714) . Hence commands such as 
10 InterActual .GetBCAField () can get the BCA information from 
the navigator state module (714) after insertion of a disc. 
^ This BCA information provides the ability to uniquely identify 

*0 each disk by serial number. Conditional access to content, 

i,i usage tracking, and other marketing techniques are implemented 

IR 15 thereby. The identifier engine (710) gets the BCA information 

for the serial identifier (SeriallD) , hashes the video .IFO 
** 3 file to identify the title (called the MedialD) , and then 

H reads the ROM information to establish a data identifier 

T lis? 

(DatalD) for the HTML/ JavaScript data on the disc. The 
|4; 20 identifier engine (710) provides this information to the 
f-f navigator state module (714) which stores this information and 

provides it to whichever of the command handler (702) , 
properties handler (704), or event generator (706) needs it. 
The identifier engine (710) interacts with the navigator state 
25 module. The identifier engine (710) receives the BCA 
information (read differently than files) from the I/O 
controller (736) . The identifier engine (710) interacts with 
the cookie manager (708) to place disc related information 
read from the BCA as discussed previously herein into the 
30 InterActual System cookie. 



The initialization module (712) provides the ability 
to establish the DVD/CD navigator environment. The 
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initilization module (712) allows the internal states and the 
State Modules (i.e. the navigator state module (714)) to be 
initialized. This initialization also includes reading the 
current disc in the drive and initializing a system cookie. 
It is noted that the embedded web browser (410) interfaces 
which allow registering a callback for the event handler are 
established at power-up as well. 

The navigator state module (714) provides the 
ability to coordinate user interaction and DVD behavior with 
front panel controls and/or a remote control. In one 
embodiment, arbitration of control happens in the navigator 
(422) itself between the remote and front panel controls. 
DVD/CD navigator (722) playback is initiated by the navigator 
state module (714) in response to input from the 
initialization module (712) . The navigator state module (714) 
receives locations of book marked points in the video playback 
from the bookmark manager (716) and controls the DVD/CD 
navigator (422) accordingly. 

The bookmark manager (716) provides the ability for 
the JavaScript content to mark spots in video playback, and to 
return later to the same spot along with the saved parameters 
which include angle, sub-picture, audio language, and so 
forth. The bookmark manager (716) provides the ability to use 
video bookmarks in conjunction with web bookmarks. As an 
example, a video bookmark is set, a web session is launched 
going to a preset web book marked source to retrieve video- 
related information, then later a return to the video at the 
book marked spot occurs . 

The system timer (722) provides time stamps to the 
event generator (706) for use in determining events for 
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synchronization or controlled playback. 



The system monitor (724) interacts with the 
properties handler (704) . In one embodiment, the system 
5 generates a 900 millisecond timer tick as an event which the 
HTML/ JavaScript uses in updating the appropriate time displays 
as is needed. For systems that do not have a DVD Navigator 
that creates events the timer is used to poll the property 
values every 900 milliseconds and compares the poll results 
10 with a previous result. If the result changes then an event 
is generated to the HTML/ JavaScript . 

The system initialization (726) provides 
initialization control whenever the system is turned on or 
. . a 15 reset. 



m 



The DVD decoder (427) generally receives the media 
13 stream from the I/O controller (736) and decodes the media 

stream into video and audio signals for output. The DVD 
20 decoder (426) receives control from DVD/CD navigator (422) . 

The CD-DA decoder (734) receives a media stream from 
I/O controller (736) and decodes it into audio which it 
provides as output . 

25 

The I/O controller (736) interfaces with disk (738) 
and controls its physical movement, playback, and provides the 
raw output to the appropriate decoder. The I/O controller 
(736) also provides disk state information to identifier 
30 engine (710) . 

The disk (738) can be any media disk such as, but 
not limited to, DVD-ROM, DVD-Audio, DVD-Video, CD-ROM, CD- 
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Audio . 

Referring to FIG. 8, shown is a media disk directory 
structure according to one embodiment ♦ 

5 

Shown are a disk (802) , a /ROOT directory (804) , a 
/ COMMON directory (806), a /MAC directory (808), a /WIN 
directory (810), a /NUON directory (812), and a /SONY 
directory (814) • 

10 

The disk (802) includes each of the directories 
listed: the /ROOT directory (804), the / COMMON directory 
(806), the /MAC directory (808), the /WIN directory (810), the 
/NUON directory (812), and the /SONY directory (814). 

15 

In one embodiment, the application programming 
interface (API) uses the file structure depicted in FIG. 8 to 
access platform-specific binaries. Platforms for which 
directories are defined include the /MAC (Macintosh operating 

20 system), /NUON (VM labs, NUON technology), /SONY (Sony 

playstation) , /WIN (Microsoft Windows operating systems) , 
Other directories are allowed and can be used when desired, 
such as /LINUX (for the LINUX operating system) , /NINTENDO 
(Nintendo Dolphin) , /SEGA (Sega Dreamcast) , and /XBOX 

25 (Microsoft X-Box) . 

The directory structure allows for proprietary 
executable binary files for each platform. The platform- 
specific directory structure and its associated set of 
30 binaries enable any platform to run executables specifically 
designed for that platform. This capability, in essence, 
allows the platform-specific binaries to override the general 
purpose content, or override the standard browser mechanism. 
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While actual ROM content may reside in a platform directory, 
in one embodiment, all ROM content resides in the /COMMON 
directory (806) when possible. The /COMMON directory (806) 
can support any number of subdirectories including platform- 
specific directories. 

The / COMMON directory (806) and platform-specific 
directories are standardized, however, each platform developer 
is free to create their own subdirectory structure under their 
reserved platform-specific directory. As example, Sony may 
create PS2 and PS3 subdirectories under the /SONY directory 
(814) . 

The /COMMON directory (806) stores the actual ROM 
content (as opposed to platform-specific binaries) . It is 
recommended that all ROM content, including platform-specific 
ROM content, reside in this directory as this facilitates an 
intuitive content development approach and provides an easy 
way for JavaScript to be used to detect platforms and render 
the appropriate HTML pages tailored to specific platforms when 
required. 

Even if platform- specific binaries are included on 
the disk, the general purpose content can still be called. In 
one embodiment, a DVD utilizes the directory structure by 
placing the Windows version of software in the /WIN directory, 
the Macintosh version of PCFriendly in the /MAC directory 
(808) , and so forth. Upon insertion of the disk, whichever 
platform the disk has been inserted into will execute the 
appropriate binaries (found in that platform=s directory and 
autorun) , and these binaries thereafter load the INDEX . HTM 
file located in the /COMMON directory (806) , which is the 
starting point for any general -purpose InterActual-compatible 
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disk. The meta-data tag in the head section of the INDEX . HTM 
file, in one embodiment, contains the Application programming 
interface (API) version information. The INDEX . HTM file 
serves as a background container web page during standard 
playback that allows JavaScript event handlers to be loaded 
and activated to handle button events during playback. 
JavaScript can be used to detect platforms and render the 
appropriate HTML pages customized for those platforms. 

The specifications for DVD-video and DVD-audio 
require that each disk contain specific directories and files. 
As example, DVD- video files are contained in a directory named 
VIDEOJTS and DVD-audio files are contained in a directory 
named AUDIOJTS. There is no such requirement for DVD-ROM, so 
developers can arrange files in any desired manner. 

Files stored for use with InterActual- compatible 
disks can be in any DVD disc directory. In the case where no 
platform-specific executable file exists, there must be a 
method which allows the browser and/or playback engine to 
identify the initial HTML file. 

During disk creation, DVD-video zone files must be 
placed physically at the beginning of the disk, contiguously, 
in the order specified by the DVD- video specification. 
Likewise, DVD-audio zone files must follow the DVD-video files 
in contiguous order. 

In one embodiment, the VIDEOJTS and AUDIOJTS 
directories are the first entries in the directory descriptor. 
In one embodiment, the ROM zone files are placed in 
subdirectories rather than the /ROOT directory. 
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The placement of files on a dual -layer disk (DVD- 9, 
DVD-14, or DVD-18) is generally independent of the layer 
details, DVD-video and DVD-audio files must begin on layer 0. 
ROM zone files are placed at the end, beginning on whichever 
5 layer the DVD-video (or DVD-audio) files end on, and can cross 
the layer boundary if needed. 

DVD authoring systems and tools support different 
naming capabilities such as UDF, ISO-9660, ISO-9660 with 
10 Joliet extensions, Macintosh file names, Macintosh resources, 
hybrid disks, etc. Some authoring systems force a certain 
m character capitalization (such as all capitals) . 

^ The disk insertion flow of FIG. 8 is commonly 

|y described in terms of phases. 

B 15 

Iff The first phase is InterActual disk detection where 

fn 

" ! the disk is checked to determine if it has InterActual 

%■ 

13 content. This is done by seeking the INDEX.HTM file in the 

J$ /COMMON directory on the disk. If the INDEX.HTM file exists, 

20 then the DVD is compatible with the present embodiment, 
J? otherwise, it is not. 

The second phase is disk type detection where the 
disk is checked to determine if it is a DVD-Video, DVD-Audio, 
25 or CD-DA disk. 



The third phase is player mode detection where the 
device is checked to determine the default playback mode for 
the system. This is done by reading the player mode by the 
30 properties query InterActual . PlayerMode . When the device is 
configured for play mode, content in accordance with the 
present embodiment, in one embodiment, is bypassed. 
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If the default playback mode for the device is 
"InterActual" mode, then content in accordance with the 
present embodiment is launched beginning with 
/COMMON/ INDEX . HTM . The content itself can be updated 
5 dynamically if there is an active Internet connection. When 
there is no active Internet connection, the device will render 
the content from the disk ROM. 



■s-fcs? 



IP 



f 



For disks not in accordance with the present 
10 embodiment in players with a default playback mode of 

"InterActual, " the default content homepage (CONNECT.HTM) is 
rendered and an Internet connection is attempted to 
potentially provide web content. 



15 The fourth phase is platform-specific file detection 



Iff where directories on the disk are checked to determine if any 

platform-specific files are located. This is done by 
searching for the appropriate file structures for the device. 



20 The fifth phase is internet connection determination 

where the device is checked to see whether an Internet 
connection is active or possible. The system can access and 
updated content files for the current title of disks in 
accordance with the present embodiment. For non-enhanced 
25 titles, the system will look online to see if there is any 
content available for the current title. If there is such 
content, the system can offer the same interactive experience 
as a title in accordance with the present embodiment affords. 

30 When the device is in player mode play, a disk in 

accordance with the present embodiment can display a logo to 
signify that there is content in accordance with the prtesent 
embodiment available from the disk ROM. 
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Referring to FIGS. 9, shown is part 1/2 of one 
exemplary algorithm 900 for handling disk insertion according 
to one embodiment resulting in the launching of different 
contents depending on disk determinations. 

Algorithm 900 begins when a user inserts a media 
disk into a device at "insert disk" block (902) and determines 
if the inserted disk is a DVD or music CD in accordance with 
the present embodiment block (904) . 

When the determination (block 904) is that the 
inserted disk is not a disk in accordance with the present 
embodiment, the algorithm (900) continues through connector A 
(906) to the corresponding connector A in FIG. 10. 

When the determination (block 904) is that the 
inserted disk is a disk in accordance with the present 
embodiment, the determination is next made whether the disk is 
a DVD (block 908) . 

If the result of the determination of block 908 is 
that the disk is a DVD, a check is made whether the author 
mode is movie mode or system mode (block 910) . If the author 
mode is movie mode, standard DVD playback is initiated (block 
914) . If the author mode is system mode, the determination is 
made whether the default player mode is "InterActual" (block 
912) ♦ If it is not, the algorithm (900) launches standard DVD 
playback (block 914) . If it is, the determination is made 
whether platform specific binaries exist for the current 
platform (block 916), and if so, platform specific binaries 
are launched (block 918) . If no platform-specific binaries 
are found, the determination is made whether there is an 
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active Internet connection (block 920) , and if not, the file 
INDEX.HTM is launched from the DVD (block 922) . If there is 
an active Internet connection, a check is made for web content 
for the current title (block 924) , and if there is content for 
5 the current title it is displayed (block 926) . 



If the result of the decision at block 908 is that 
the disk is not a DVD, the determination is next made whether 
the default player mode is "InterActual" (block 930) and if 
10 not, CD standard playback is launched (block 932) . If the 

default player mode is " InterActual , " a check is made for any 
m platform-specific binaries (block 934) and if any are present, 

r is? 

^ the platform-specific binaries are launched (block 936) . If 

Saw 

|y there are no platform-specific binaries, a check is made 

j'j 15 whether there is an active Internet connection (block 93 8) and 

m if not, INDEX . HTML is launched from the CD-ROM (block 940) . 

If there is an active Internet connection, a check is made for 
p web content for the current title, and if there is any, it is 

pi 

displayed (block 944) . If there is no web content for the 
U 20 current title, INDEX . HTML is launched from the CD-ROM (block 
W 940). 

Identifying InterActual -compatible discs 
A disc in accordance with the present embodiment is 
25 detected by checking for the existence of the 

/COMMON/ INDEX. HTM file. The application programming interface 
(API) version information can be found in the meta-data area 
of the HTML file. 



30 Referring to FIG. 10, shown is part 2/2 of the 

exemplary algorithm 900 for handling disk insertion according 
to one embodiment resulting in the launching of different 
contents depending on disk determinations. 
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Algorithm 900 continues from connector A (connector 
906) in FIG. 9 and begins at connector A (connector 1002) in 
FIG. 10. A determination is made whether the disk is a DVD 
5 (block 1004) and if the disk is a DVD, a check is made whether 
the default player mode is InterActual (block 1006) . If the 
default mode is not "InterActual, " standard DVD playback is 
launched (block 1008) . If the default playback mode is 
11 InterActual, " then DEFAULT . HTM is launched from memory (block 
10 1014) . 



*1 If the disk is determined to not be a DVD (block 

Bsr 

- ^5 

^ 1004) , a check is made whether the default player mode is 



|y "InterActual" (block 1010) and if it is not, standard playback 

IP 

15 is launched (block 1012) . If the default player mode is 
in . "InterActual" (block 1010), DEFAULT * HTM is launched from 
**' memory (block 1014) . After launching DEFAULT.HTM, a check is 

0 made whether an active Internet connection exists (block 1016) 

and if not, standard playback is launched (block 1018) . If an 
20 active Internet connection exists, a check is made for online 
content for the current title (block 1020) . If no online 
content is found for the current title, standard playback is 
initiated (block 1018) . If online content for the current 
title is found, the online content found is displayed (block 
25 1022) . 



FIG. 11 shows a general exemplary diagram of 
synchronous viewing of content according to one embodiment . 

30 Shown are a server (1102) , an Internet (1104) , an 

InterActive device (1106) , and an InterActive device 2 (1108) . 



The server (1102) is coupled to the Internet (1104) 
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shown by a bi-directional arrow. The Internet (1104) is 
coupled separately to both the interactive device (1106) and 
the interactive device 2 (1108) shown by bi-directional 
arrows . 

DVDs can be used for multiple user synchronous use. 
Generally, this is done by having a prearranged time for an 
event (such information could be programmed on the disk or 
provided to users from online content accessed via the disk) 
at which time interested users connect to a prearranged 
website by use of the appropriate disk. The network site can 
control all connected devices by sending commands such as 
play, pause, fast forward, etc. By this manner, content 
resident on the disks as well as live web-originated content 
can be synchronously interwoven for any number of connected 
users simultaneously. With the server being coupled to the 
interactive devices the server can send commands to these 
devices for remotely controlling content stored on local 
interactive devices connected to a network system, such as the 
Internet. First, the interactive devices begin with the same 
interactive content, such as a DVD-Video disk. The 
interactive devices and a server are adapted to be connected 
to a network. In operation, information is transmitted from 
the server to the interactive devices that begin playback of 
the interactive content utilizing the network. Each 
interactive device receives the command at the same time and 
thus the commands and therefore the content are synchronized 
at start of playback. If the interactive devices support 
different commands such as a playing at a given time or only 
playing at a given chapter the server must utilize the 
supported features for the interactive device and send out 
only the supported commands to the interactive devices. This 
allows for the simultaneous playback of the event on each of 
the client apparatuses. Late synchronization can be achieved 
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by a similar method by sending a command from the server to 
the interactive devices of the current time position the DVD- 
Video is playing. For those interactive devices that only 
support chapter commands the server must wait until the next 
chapter change to send the command to the interactive device 
to synchronize with the other interactive devices currently 
viewing the DVD-Video. Furthermore, This allows content such 
as DVD Video content to be locked so that play can only be 
accomplished through verification of interactive devices 
identity and also allows augmentation and supplementation of 
tha content provided by the video from a remote server. Upon 
verification of a interactive device's credentials, the 
locally stored content can be supplemented with additional 
content delivered over the network system. This is achieved 
by using precise command sequences from the server to the 
interactive devices that unlock the local DVD-Video for 
example . 

Network controlled synchronization 

DVDs can be used for multiple user synchronous use. 
Generally, this is done by having a prearranged time for an 
event (such information could be programmed on the disk or 
provided to users from online content accessed via the disk) 
at which time interested users connect to a prearranged 
website by use of the appropriate disk. The network site can 
control all connected devices by sending commands such as 
play, pause, fast forward, etc. By this manner, content 
resident on the disks as well as live web-originated content 
can be synchronously interwoven for any number of connected 
users simultaneously. 

Referring to FIG. 12, shown is a depiction of user 
interaction using a remote control. 
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Shown are a "view button pressed" block (1202) , a 
web view (1204), a content view (1206), an InterActual mode 
(1208) , and a full-screen mode (1210) . 



5 A user has two views between which he or she can 

switch, one being from the world wide web (WWW) and the other 
being from the disk content. Users accessing a display device 
(102) by remote control has, in one embodiment/ access to both 
views (or "worlds") at any time through the "view" button. 
10 Additionally, in one embodiment, a graphics subsystem can 
support this by having two graphic "planes," one for each 
Q view. By having a separate disk content view, the content 

owner can control the presentation of information (scripts, 
pictures, videos, etc J . This aids in merchandising of the 



15 content. 



i.y 
w 

*f 1 

r In the example of FIG. 12, by use of a remote 

fH 

*J control view button at "view button pressed" block (1202) , the 

iy user can select either the web view (1204) or the content view 

20 (1206) . The content view (1206) is the INDEX . HTM file 
\& (residing in the / COMMON directory on a disk) which is a 

cross-platform (or multi-platform) file designed to be 
viewable on substantially all of the supported platforms. 
Alternatively, the content view (1206) is the CONNECT . HTM file 
25 from the storage of the device (used in lieu of the INDEX . HTM , 
for example, when no disk is inserted, or when a disk not in 
accordance with the present embodiment is inserted) . 

The web view (1204) is the InterActual-compatible 
30 device=s "home page." This page is under the control of the 
device manufacturer. As an example, this page may contain the 
manufacturer's logo and/or system (device) specific 
information. Alternatively, this page may be determined by 
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user-controlled settings of the device. 



The content view (1206) is the content "home page" 
and resides at / COMMON/ INDEX * HTM (on a disk) or as CONNECT , HTM 
in the device=s memory (e.g. flash ROM) . Depending on the 
player mode of the device, the content view (1206) can default 
to either "InterActual" mode (1208) or full-screen mode 
(1210) . 

When a disk contains "InterActual" content, the 
content authors can create it such that the user experience 
begins with the "InterActual" content. This is an option 
available to the disk authors at the time of authoring. 

Referring to FIG. 13, shown is a remote control 
according to an embodiment of the present invention. 

Shown is a remote control (1300) , having a back 
button (1302), a view button (1304), a home button (1306), an 
IA (InterActual) button (1308) , a stop button (1310) , a next 
button (1312) , a prev button (1314) , a play button (1316) , an 
up button (1318), a left button (1320), a right button (1322), 
and a down button (1324) . 

The back button (1302) has different uses. In an 
Internet view, the back button (1302) goes back to the 
previously-visited web page. In a content (from disk) view, 
the back button (13 02) goes back to the last web page or 
video/web page combination which was viewed. 

The view button (1304) switches between a full- 
screen Internet (or web) view to a full -screen content (from 
disk) view. 
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The home button (1306) has different uses. In an 
Internet view, the home button (1306) goes to the devices 
home page which, as example, could be the manufacturers page 
or a user-specified page if changed by the user. In a content 
(from disk) view, the home button (13 06) goes to the content 
home page which, as example, could be INDEX . HTM from the disk 
ROM or CONNECT . HTM from the flash system memory. 

The IA button (1308), or " InterActual" button, is a 
dedicated button which is discussed in greater detail under 
the subheading "context sensitive application" later herein in 
reference to FIG. 13. 

The playback buttons, stop (1310), next (1312), prev 
(previous) (1314) , and play (1316) , control the video whenever 
there is video being displayed (either in full-screen mode or 
in a window) . If no video is being displayed, pressing of the 
play button (1316), in one embodiment, loads a special page 
VIDPLAY.HTM if it is present in the /COMMON directory of an 
inserted disk ROM. If the VIDPLAY.HTM file is not found, 
pressing of the play button (1316), in one embodiment, plays 
the DVD in full -screen video mode. 

The navigation buttons, up (1318), left (1320), 
right (1322), and down (1324), in one embodiment, do not work 
for DVD navigation unless video is playing in full-screen 
mode. If video is playing in a window within a web page, 
these buttons enable navigation of the web page, especially 
useful for navigating to and selecting HTML hyperlinks. In 
this embodiment, the windowed video will be a selectable 
hyperlink as well. Selecting the video window (by an enter 
button not shown) causes it to change to full -screen video. 
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In another embodiment, a mouse or other pointing device such 
as a trackball, hand glove, pen, or the like can be integrated 
with the system. 

Context Sensitive Application 

In one embodiment, use of a unique event and a 
special button on the remote control (1300) , a specific 
section in the media can trigger a context-sensitive action. 
Events that are used for this purpose are context sensitive to 
the media content. As example, an event can trigger during a 
certain scene, upon which, in response to a user=s selection 
of an object within the scene can display information relating 
to the selected object. 

In one embodiment, when media content subscribes to 
a particular event for context sensitive interaction, which 
can be done on a chapter or time basis, the DVD navigator can 
optionally overlay transparently some place on the display 
alerting the user that context-sensitive interaction is 
available. Similar to when a network logo is transparently 
displayed at the bottom of a television screen, in one 

embodiment, an InterActual logo is displayed to signify there 

i 

is more info available for the displayed scene, and so forth. 
This ability is implemented through the media services (420) 
and the graphical subsystem of the DVD navigator (622) . 

Regarding FIG. 14, shown is an example of a computer 
to Internet connection according to one embodiment. 

Shown are a server 1402, an Internet 1404, a cookie 
1406, and a computer 1408, 

The server 1402 is coupled to the Internet 1404. 
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The Internet (1404) is coupled to the computer (1408) with the 
cookie (1406) shown being communicated along the connection 
between the computer (140 8) and the Internet (1404) . 

5 In operation, a user causes computer (1408) to 

access a web page resident on the server (1402) via the 
connections through the Internet. In so doing, the website 
containing the accessed web page causes the cookie (1406) to 
be sent to the computer (1408) and stored on a local storage 
10 drive for later reference by the storing website. 

A cookie is information that a web site (server side 
program) puts on a client=s computer or permanent storage so 
that information is retained from browsing session to browsing 

15 session (or later use in the same session) . Typically, a 
cookie records user-specific information such as past user 
choices during interaction with the web site. Cookies are 
useful because the nature of the hypertext transfer protocol 
(HTTP) used by the World Wide Web (WWW) is that each web page 

20 request is completely independent of all other requests. Thus 
a cookie is a mechanism which allows a web site to retain 
access to past interaction history with particular clients. 

The embedded browser supports two types of cookies, 
25 system cookies and general -purpose cookies. System cookies 
are predefined in both name and size as part of the 
Application programming interface (API) . System cookies are 
automatically created and modified by the player hardware and 
embedded browser. General -purpose cookies are cookies that 
30 can be placed by web pages. Both system cookies and general- 
purpose cookies may be volatile or non-volatile (maintained 
even if storing system is powered off) depending on their 
specific function. 
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The following cookies are supported by the 
application programming interface (API) : 



5 Platform cookie, a non-volatile cookie of 32 bytes 

length that contains unique hardware information, including a 
hardware identifier for the device. 



UserlD cookie, a non-volatile cookie of 32 bytes 
10 length that contains unique user login information (useful for 
mult i -user households) . 



^5 An application programming language version cookie, 

a non-volatile cookie of 32 byte in length which maintains 
15 version information for the supported levels of the 
application programming interface (API) . 



If; 
t ft 



3- 



Player Mode cookie, a non-volatile cookie of 32 

fy bytes length which maintains the default player mode for the 

\& 

20 Application programming interface (API) playback, movie mode, 

N s or InterActual mode . 



Disk cookie, a volatile cookie of 214 bytes length 
which contains currently inserted disk information including a 
25 unique ID generated by local hardware based on hashing 

algorithm provided by InterActual and (2) the id field from 
PCFreindly titles (based on the file DISC. ID) provided the 
disk is a PCFreindly (PCF) disk. This cookie is generated 
with null content when no disk is currently in the drive. 

30 

The application programming interface (API) also 
provides for a minimum of 100 general -purpose cookies that can 
be used by general web sites. Each of these cookies can be up 
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to 200 bytes in size, therefore the minimum storage 
requirement for cookies is determined as follows: 



10 



4 reserved 32 byte system cookies = 128 bytes 
1 reserved 214 byte system cookie =214 bytes 
100 general -purpose cookies of 200 bytes = 20,000 

bytes 

Thus total cookie storage is a minimum of 20,342 

bytes . 

Referring to FIG. 15, shown is an example of a 
bookmark according to one embodiment. 



in 

■4 15 screen image (1506) 



Shown are a video (1504) , a bookmark (1504) , and a 



a In operation, bookmark (1504) records the necessary 

P 

information to return to the same point in the video playback 
f0 of video (1502) by recording the title number, time position, 

p; 20 chapter, angle, sub picture, and language. 



Bookmarks maintain the state of player by storing 
general parameter registers (GPRMs) for a specific title. 
Video bookmarks mark where the video player state was last . 
25 For the application programming interface (API) , one bookmark 
per title is required. In one embodiment, 32 bookmarks are 
recommended . 



A bookmark has a minimum size of 10 bytes. There is 
30 at least one bookmark per disk. These bookmarks are managed 
in a queue such that creating a new bookmark for a specific 
disk (using the disk cookie) will overwrite the last bookmark 
in the queue for that disk provided the queue is full. If a 
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new disk is encountered, the oldest bookmark of the set is 
overwritten. In one embodiment, a capacity of 32 bookmarks is 
required, which requires a minimum of 320 bytes of persistent 
storage . 

A more detailed treatment of bookmarks and the 
bookmark queue is presented in Application programming 
interface (API) Specification® (hereby incorporated by 
reference) . 

Bookmark structure is described in table 1. 



Table 1 



byte 
offset 


field name 


description 


■ - 

data 
type 


0 


TitleNumber 


number of title (1-99) 


signed 
byte 


1-5 


ElapsedTime 


time in elapsed 
milliseconds from start 
(0 to 2^31 - 1) 


signed 4 
byte 


6 


Chapter 


Chapter (1-99) 


signed 
byte 


7 


Angle 


Angle (1-9) 


signed 
byte 


8 


sub picture 


Sub picture (0-31) 


signed 
byte 
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9 


AudioLang 


Audio Language (1-99) 


signed 








byte 



p 10 



73 

in 



9 it; 



Content caching 

In an embodiment, one megabyte (1MB) of cached 
simultaneous content is recommended. In an embodiment, the 
cache size should be specified in the hypertext transfer 
protocol (HTTP) header sent between the player and attached 
servers. Larger local storage for caching web pages and the 
like can be used with the present invention. 



Content Support 

In one embodiment, the Application programming 
interface (API) content support for fully compatible 
InterActual- compliant devices is defined in the two areas of 
15 content format support and content type support as follows: 

Content format support 

Content format support, according to one embodiment 
of the present invention, includes hypertext transfer protocol 

20 (HTTP) version 1.0, hypertext markup language (HTML) version 
4.0 (frames, tables, event handler extensions), (CSS) version 
1, (DOM) version 0, ECMAScript version 1.1 (note ECMAScript 
and DOM 0 is equivalent to JavaScript version 1,1. Requires 
platform and language detection), (SSL) version 2.0, 

25 Application programming interface (API) version 1.0 

(embedding, commands, properties, and events) , cookies (used 
to store hardware platform information and essential disk 
identification information) . 



30 



Content type support 
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Mandatory content type support includes MPEG1 and 
MPEG2 video files, WAV, AU, AIFF, and MP3 audio files, GIF, 
JPEG, and PNG graphics files 



5 Advanced format support 

The advanced format support is not required for a 

standard implementation. Advanced formats include, but are 

not limited to, Macromedia Flash (this is encouraged as Flash 

is very popular for studio DVDs) , extensible markup language 

10 (XML), Chat, and streaming media such as MPEG4, Real Player, 

and Quicktime. With the advent of modern and other advanced 

Internet connectivity solutions, more additions to the advance 

SO format capabilities will be made. 
)0 

ly 

15 More complex menu structures 

Ifl A DVD-Video is shipped with a simple HTML page that 

* M does little except start a movie. However, it also checks to 

P see if that movie has any web site updates. If it does, then 

;** it launches a new movie menu that is downloaded from the web. 

|4 20 Obviously, the downloaded menu can be designed much later than 
J*; the DVD. The menu may have e-commerce opportunities, such as 

promoting gifts for purchase, tickets for the sequel to the 
movie on the DVD, etc. The window of time of these 
opportunities is decided by the content owner and is 
25 completely independent of the DVD. The menu can have links to 
actors/actresses featured in the DVD. Additionally, the menu 
can provide options to navigate the DVD with finer granularity 
than the original chapters on the DVD provide . 

3 0 Special coupon from retailer 

DVDs authored with different logos at the head (such 
as logos for Best Buy, Circuit City, or the like) can be used 
for advertising purposes. For example, the disk start-up can 
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be specified to display the logo of the original retailer and 
the consumer can be directed to access the retailer's website 
for promotional advertisements. This can be accomplished by 
checking the burst cutting area (BCA) on the disk which would 
5 indicate the identity of the retailer. 

InterActual Application Programming Interface 

Following is presented an exemplary list of the commands, 
10 properties, and events for several embodiments of the 

InterActual Programming Interface. This list is presented as 
follows: 



SO 



■u 



A The DVD-Video and CD-Digital programming interface 
If! 15 A.l Commands 

.5 A. 2 Properties 

Cm A. 3 Events 

J-s* A. 4 Interface Applicability 

10 B The DVD-Audio Specific Interface 

!^ 20 B.l Commands 

Q B.2 Properties 

B. 3 Events 

C Advanced InterActual API 

C . 1 Commands 

25 C.2 Properties 

C.3 Events 

A The DVD-Video and CD-Digital programming interface 

30 A.l Commands 

Commands will control the playback and navigation mechanisms of 
a DVD-Video/Audio or CD-DA disc. Commands can be used by the 
calling application (HTML/ JavaScript) to initiate these 
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functions. This section provides a detailed description of each 
InterActual command with its associated parameters , 



10 



1) All commands support return values. These will all be 

JavaScript numbers, however the underlying API 
implementation should set a signed 4-byte (32-bit) 
value for each of these. 

2) Each command lists applicable return values. 

3) A w -3" will be returned for commands not supported by a 

specific system or navigator. 



il! 15 



20 



25 



A • 1 . 1 InterActual . Play ( ) 

Summary : 

Starts playback of the DVD. 
Parameters : 

None required 
Example : 

This command controls playback of the video. 
InterActual . Play ( ) 
Notes: 

For DVD Video this command starts playing from the 
First Play PGC. See also: InterActual . PlayTi tie (t) / 
InterActual . PlayChapter (t , c) ; 
InterActual . PlayTime (t , h, m, s , x) 
Media Supported: 



DVD 
Video 


DVD Audio 


CD 

Audio 


X 


X 


X 



Return Values; 



Number 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 
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-2 


UOPNotAllowe 
d 


Operation not allowed by current 
UOP fields 


-3 


NotSupported 


File type or feature not 
supported at this time 


-5 


NoDisc 


Attempt to play with no disc 



2 InterActual. PlayTi tie (t) 

Summary: 

Start playback at the specified title number. 
Parameters : 

t Title number ranging from 1-99; signed 1 
byte integer 

Example : 

Play title number 3 . 

InterActual . PlayTitle (3) 
Notes: 

This command requires that the U0P2 operation is 
permitted. 
See also: 

InterActual . Play ( ) ; InterActual . PlayTime (t , h, m, s , x) ; 
InterActual . PlayChapter ( t , c) 
Media Supported: 



DVD 
Video 


DVD Audio 


CD Audio 


X 







Return Values: 



Number 


Name 


Description 


0 


OK 


Successful 


-1 


General Error 


Unknown error condition 


-2 


UOPNotAllowe 
d 


Operation not allowed by current 
UOP fields 


-5 


NoDisc 


Attempt to play with no disc 


-6 


ParmRangeErr 


Parameter out of range or invalid 
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. 3 InterActual . PlayChapter ( t , c) 

Summary : 

Start playback at the specified title number and 
chapter value. Parameters: 
t Title number ranging from 1-99; signed 1 

byte integer 
c Chapter number ranging from 1-99 for 

One_Sequential_PGC_Title 
Chapter number ranging from 1-999 for 
MultiJPGCJTitle 
Signed 2 byte integer 

Example : 

Play the 2 nd chapter of title number 6. 
InterActual ♦ PlayChapter (6,2) 

Notes : 

If in TTJDOM and already within specified title, 
InterActual . SearchChapter is issued to maintain GPRM 
values. Otherwise, InterActual .PlayChapter is issued. 
Requires : 

This command requires that the U0P1 operation be 
permitted. 
See also: 

InterActual . PlayTitle ( t } ; InterActual . SearchChapter (c) 
Media Supported 



DVD 
Video 


DVD Audio 


CD Audio 


X 







Return Values 



Number 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 
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-2 


UOPNotAllowe 
d 


Operation not allowed by current 
UOP fields 


-5 


NoDisc 


Attempt to play with no disc 


-6 


ParmRangeErr 


Parameter out of range or invalid 



• 4 InterActual . PlayChapterAutoStop (t, c, n) 

Summary : 

Start playback of the specified title t at chapter c 
for n chapters. 
Parameters : 

t Title number ranging from 1-99; signed 1 byte 
integer 

c Chapter number ranging from 1-99 for 

One_Sequential_PGC_Title 

Signed 2 byte integer 
n Number of chapters to play ranging from 1 - 

998; a value of u l" signifies that the chapter 

w c" will be played and play will stop after 

that chapter; 

Signed 2 byte integer 

Example : 

Play the 2 nd , 3 rd and 4 th chapters of title number 6. 
InterActual . PlayChapterAutoStop (6,2,3) 

Requires : 

This command requires that the U0P1 operation be 

permitted. 
See also: 

InterActual . PlayChapter ( t , c) 
Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 







55 of 225 



Return Values 



JNiurnoer 


Name 


Description 


u 




Qi i /-*/"■» C«*Fl 1 1 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAllowe 
d 


Operation not allowed by current 
UOP fields 


-5 


NoDisc 


Attempt to play with no disc 


-6 


ParmRangeErr 


Parameter out of range or invalid 



. 5 InterAc tual . PlayTime ( t , h , m, s , x) 

Summary : 

This command starts playback in the specified title 
number (t) at the specified time in hours (h) , minutes 

(m) , seconds (s) and milliseconds (x) . For DVD-Audio, 
the first parameter represents the title group number 

(t) . 
Parameters 

t DVD-Video: Title number ranging from 1-99 
DVD-Audio: Title group number ranging from 1 
- 9 

CD -Audio: Track number ranging from 0-99 
where 

if t = 0 then h, m, s are relative to the 
start of the CD -Audio, 
else t is the track number and 
the h, m, s are relative to that track 
Signed 1 byte integer 
h Hours where h can range from 00-23; signed 

1 byte integer 
m Minutes where m can range from 00 - 59; 

signed 1 byte integer 
s Seconds where s can range from 00-59; 
signed 1 byte integer 



Milliseconds where x can range from 0-999 
(e.g. 1 would be interpreted as 0.001 second; 
for video, this will be rounded to the 
nearest frame) 

Signed 2 byte integer 



q 

rfef 

111 10 

M 

in 



ru 

U 15 



Examples : 

Start playing from the specified time position of the 
current title. For example to play title 2 from 1 
hour, 10 minutes, 3 0 seconds, millisecond 79 in the 
title 

Inter Ac tual ♦ PlayTime (2,1,10,30,79) 

Notes: 

If in TT_D0M or TT_GR__DOM and already within a 
specific title, InterActual . SearchTime is issued to 
maintain GPRM values. Otherwise, InterActual. PlayTime 
is issued and the GPRM registers are initialized. 
Requires: 

DVD-Video: This command requires that the UOP0 

operation be permitted. 
See also: 

InterActual .SearchTime (h,m, s,x) 
Media Supported: 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 


X 



Return Values 



Number 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 




UOPNotAllowe 


Operation not allowed by current 


-2 


d 


UOP fields 
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-3 


NotSupported 


File type or feature not 
supported, at this time 


-5 


NoDisc 


Attempt to play with no disc 


-6 


ParmRangeErr 


Parameter out of range or invalid 



InterActual , PlayTimeAutoStop (t, sh, sm, ss, sx, eh, em, es, ex 

) 

Summary 

This command starts playback in the specified title 
number (t) at the specified start time in hours (sh) , 
minutes (sm) , seconds (ss) and milliseconds (sx) and 
ends at the specified end time (using the same 
variables for hours, minutes, seconds and 
milliseconds; eh, em, es, ex) * For DVD-Audio, the 
first parameter represents the title group number (t) . 
Parameters 

t DVD-Video: Title number ranging from 1-99 

DVD-Audio: Title group number ranging from 1 - 
9 

CD-Audio: Track number ranging from 0-99 
where 

if t = 0 then h, m, s are relative to the 
start of the CD- Audio, 
else t is the track number and 
the h, m, s are relative to that track 
Signed 1 byte integer 
sh Start hour where h can range from 00 - 23; 

Signed 1 byte integer 
sm Start minutes where m can range from 00 - 59; 

Signed 1 byte integer 
ss Start seconds where s can range from 00 - 59; 
Signed 1 byte integer 
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sx Start milliseconds where x can range from 0 - 
999 

(e.g. 1 would be interpreted as 0.001 second; 
for video, this will be rounded to the nearest 
frame) ; 

Signed 2 byte integer 

eh End hour where h can range from 00 - 23; 

Signed 1 byte integer 
em End minutes where m can range from 00 - 59; 

Signed 1 byte integer 
es End seconds where s can range from 00-59; 

Signed 1 byte integer 
ex End milliseconds where x can range from 0 - 

999 

(e.g. 1 would be interpreted as 0.001 second; 
for video, this will be rounded to the nearest 
frame) 

Signed 2 byte integer 

Examples 

Start playing from the specified time position of the 
current title to the end position. For example to play 
title 2 from 1 hour, 10 minutes, 30 seconds, 
millisecond 79 in the title to 1 hour, 11 minutes, 30 
seconds and 0 milliseconds: 

Inter Ac tual . PlayTimeAutoS top (2,1,10,30,79,1,11,30,0 
) 

Requires 

DVD-Video: This command requires that the UOP0 
operation be permitted. 
See also 
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InterActual . PlayTime (t , h, m, s , x) 
Media Supported 



DVD Video 


DVD 
Audio 


CD Audio 


X 


X 


X 



Return Values 



No. 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAllowe 
d 


Operation not allowed by current 
UOP fields 


-3 


Not Supported 


File type or feature not 
supported at this time 


-5 


NoDisc 


Attempt to play with no disc 


-6 


ParmRangeErr 


Parameter out of range or invalid 



• 7 InterActual • PlayTrack (g, t) 

Summary 

Start playback at the beginning of the specified track 
number with the selected title group number. 
Parameters 

g DVD-Audio: Title group number ranging from 1-9 
(within a Volume) ; signed 1 byte integer 
CD- Audio: Ignored 

t Track number ranging from 1-99; signed 1 byte 
integer 

Example 

Start playing the 2 nd track of title group 1. 
InterActual . PlayTrack (1,2) 

Notes 

If in TT_GR_DOM and already within specified title 
group, XnterActual.SearchTraofc is issued to maintain 
GPRM values. Otherwise, InterActual . PlayTrack is 
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issued. In case of CD-DA, group number should be 1 by 
default. 

This method shall not be used for the playing a Hidden 

Track. The method Inter Actual. HiddenPlayTrackO shall 

be used instead. 
See also: 

InterActual . SearchTrack { t ) ; 

InterActual . PlayTitleGroup (g) 
Media Supported: 



DVD 
Video 


DVD 
Audio 


CD Audio 




X 


X 



Return Values 



Number 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAllowe 
d 


Operation not allowed by current 
UOP fields 


-3 


Not Supported 


File type or feature not 
supported at this time 


-5 


NoDisc 


Attempt to play with no disc 


-6 


ParmRangeErr 


Parameter out of range or invalid 



8 InterActual . SearchChapter (c) 

Summary 

Jump to the beginning of the specified chapter within 
the current title. 
Parameters 

c Chapter number ranging from 1-99 for 

One__Sequential_PGC_Title 
Chapter number ranging from 1 - 999 for 
Multi_PGC_Title; Signed 2 byte integer 

Example 
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Play the 2 nd chapter of currently playing title. 
InterActual . SearchChapter (2) 
Notes : 

Maintains current GPRM values* 
Requires : 

This command requires that the U0P1 and U0P5 operations 
are permitted. 
See also: 

InterActual. PlayTitle(t) ; InterActual .PlayChapter (t , c) 
Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 







Return Values 



Number 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAllowe 
d 


Operation not allowed by current 
UOP fields 


-5 


NoDisc 


Attempt to play with no disc 


-6 


ParmRangeErr 


Parameter out of range or invalid 



. 9 InterActual . SearchTime (h,m, s , x) 

Summary 

This command starts playback at the specified time in 
hours (h) , minutes (m) , seconds (s) and milliseconds 
(x) . 
Parameters 

h Hours where h can range from 00 - 23; signed 

1 byte integer 
m Minutes where m can range from 00 - 59; 

signed 1 byte integer 
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s Seconds where s can range from 00 - 59; 

signed 1 byte integer 
x Milliseconds where x can range from 0-999 

(e.g. 1 would be interpreted as 0.001 second; 

for video, this will be rounded to the 

nearest frame) 

Signed 2 byte integer 

Examples 

Start playing from the specified time position of the 
current title. For example to play from 1 hour, 10 
minutes, 30 seconds, millisecond 200 in the title 
Inter Ac tual.S ear chTimed, 10, 30, 200) 
Notes 

Maintains current GPRM values. For CD-Audio, h, m, s 
are relative to the start of the CD-Audio. 
Requires 

DVD-Video: This command requires that the UOP0 and UOP5 

operations are permitted. 
See also: 

InterActual . PlayTime ( t , h, m, s , x) 
Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 


X 


X 


X 



Return Values 



Numbe 
r 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAllowed 


Operation not allowed by current 
UOP fields 


-3 


Not Supported 


File type or feature not 
supported at this time 
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-5 


NoDisc 


Attempt to play with no disc 


-6 


ParmRangeErr 


Parameter out of range or invalid 
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A.l. 10 InterActual . SearchTrack ( t) 

Summary : 

Start playback at the beginning of the specified track 
number with the current title group number. 
Parameters 

t Track number ranging from 1-99; signed 1 byte 
integer 

Example 

Start playing the 3 rd track of the current title group. 
Inter Ac tual . SearchTrack ( 3 ) 

Notes 

GPRM values are maintained. Should also work for CD-DA. 

See also: 

InterActual. PlayTrack(g, t) ; 

InterActual . PlayTitleGroup (g) 
Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 




X 


X 



Return Values 



NO. 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAllowe 
d 


Operation not allowed by current 
UOP fields 


-3 


NotSupported 


File type or feature not 
supported at this time 


-5 


NoDisc 


Attempt to play with no disc 


-6 


ParmRangeErr 


Parameter out of range or invalid 
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11 Inter Actual ♦ TotalNumChapters ( t) 

Summary 

Returns the total number of chapters (Part of Titles - 
PTT) available for current title/title group. 
Parameters 

t Title Number ranging from 1-99; signed 1 
byte integer 

Return Value 

JavaScript Signed 2 byte integer; 

Number Number of chapters (or PTTs) 

ranging from 1 - 999 



Nuxhbe 
r 


Name 


Description 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNot Allowed 


Operation not allowed by current 
UOP fields 


-3 


NotSupported 


File type or feature not 
supported at this time 


-5 


NoDisc 


Attempt to play with no disc 


-6 


ParmRangeErr 


Parameter out of range or invalid 



Example 

Query the total number of chapters in the title/title 
group . 

TotalChapters = InterActual .TotalNumChapters (1) 

Notes 

The Title Group range is only from 1-9. 
Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 
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. 12 InterAc tual . NextPG ( ) 

Summary 

Halts playback of the current presentation and starts 
the presentation from the beginning of the next Program 
within the same Program Chain (PGC) . 
Parameters 
None 
required 
Example 

DVD-Video Example: Proceed to the next program, 
skipping the remainder of the current program of the 
current title. 
Inter Ac tual. NextPG () 
Notes 

DVD-Video: Valid in both the title and menu domains. 
For a One Sequential PGC Title, this method halts 
playback of the current program and starts playback 
from the next program within the title. 
DVD-Audio: Valid in only video-capable DVD-Audio 
player, and only in the Audio Manager domain. 
Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 





Return Values 



No, 


Name 


Description 


0 


OK 


Successful 


-1 


General Error 


Unknown error condition 


-2 


UOPNotAllowe 
d 


Operation not allowed by current UOP 
fields 


-3 


Not Supported 


File type or feature not supported at 
this time 
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-5 



NoDisc 



Attempt to play with no disc 



13 InterActual . PrevPG ( ) 

Summary 

Halts playback of the current presentation and starts 
the presentation from the beginning of the previous 
Program with the same Program Chain (PGC) . 
Parameters 
None 
required 
Example 

DVD-Video example: Proceed to the previous program of 
the current title. 
InterActual . PrevPG ( ) 
Notes 

DVD-Video: Valid in both the title and menu domains. 
For a One Sequential PGC Title, this method halts 
playback of the current program and starts playback 
from the start of the current program within the title 
(same as TopPG_Search) . If playback is within 10 
seconds of the start of a program, however, this method 
will force the presentation to go to the start of the 
previous program. If already in first program, then 
playback starts at beginning of the program upon 
InterActual. PrevPG () . 

DVD-Audio: Valid in only video- capable DVD-Audio 
player, and only in the Audio Manager domain. 
Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 





Return Values 
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Numbe 
r 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAllowed 


Operation not allowed by current 
UOP fields 


-3 


Not Supported 


File type or feature not 
supported at this time 


-5 


NoDisc 


Attempt to play with no disc 



14 InterActual . GoUp ( ) 

Summary 

Halts playback of the current Program Chain (PGC) and 
starts the playback of the new PGC which is specified 
as GoUpjPGCN. 
Parameters 
None 
required 
Example 

Proceed to the PGC specified as the GoUp_PGCN in the 
PGCI. 

InterActual . GoUp ( ) 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 


X 


X 





Return Values 



Numbe 
r 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 
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-2 


UOPNo t Al 1 owed 


Operation not allowed by current 
UOP fields 


-3 


No t Support ed 


File type or feature not 
supported at this time 


-5 


NoDisc 


Attempt to play with no disc 



A. 1 • 15 InterActual .NextTrack () 

Summary 

Halts playback of the current track and starts playback 

from the next track in the same Title Group. 
Parameters 

None required 
Example 

Skip to the next track. 

InterActual .NextTrack () 
Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 




X 


X 



Return Values 



Numbe 
r 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAllowed 


Operation not allowed by current 
UOP fields 


-3 


Not Supported 


File type or feature not 
supported at this time 


-5 


NoDisc 


Attempt to play with no disc 



A . 1 • 16 InterActual . PrevTrack ( ) 

Summary 

69 of 225 



Halts playback of the current track and starts playback 
from the start of the current track. If it is at the 
start of a track, it will go to the start of the 
previous track. 

Parameters 

None required 

Example 

Skip back to the previous track. 
Inter Actual . PrevTrack () 

Notes 

This method halts playback of the current track and 
starts playback from the start of the current track 
within the title group (same as TopTKjSearch) . If 
playback is within 10 seconds of the start of a track, 
however, this method will force the presentation to go 
to the start of the previous track (same as 
PrevTK_Search) . If already in first track, then 
playback starts at beginning of the track upon 
InterActual . PrevTrack ( ) . 
Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 




X 


X 



Return Values 



Number 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAllowe 
d 


Operation not allowed by current 
UOP fields 


-3 


NotSupported 


File type or feature not 
supported at this time 


-5 


NoDisc 


Attempt to play with no disc 
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A. 1 . 17 InterActual . TotalTrackTime (t) 

Summary 

Returns the total time of track t in milliseconds (for 
CD-DA) . 
Parameters 

t CD-DA track number ranging from 1-99; signed 1 
byte integer 
Return Value 

JavaScript Signed 4 byte (3 2 -bit) integer 

Number ranging from 0 to 2 31 -1 



Number 


Name 


Description 


-1 


GeneralError 


Unknown error condition 


-5 


NoDisc 


Attempt to play with no disc 


-6 


ParmRangeErr 


Parameter out of range or invalid 



Example 

Query the length of track 5. 

TrackBLength = InterActual. TotalTrackTime (5) 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 






X 



A. 1 . 18 InterActual . Pause ( ) 

Summary 

Pause playback of the DVD (pause is on) . Subsequent use 
of this command resumes playback (e.g. pause is off) . 
In other words, this method operates in a "toggle" 
fashion. 
Parameters 
None 
required 
Example 
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Pause the playback. 
InterActual . Pause () 

Media Supported 



DVD Video 


DVD 
Audio 


CD Audio 


X 


X 


X 

- 



Return Values 



Nuxribe 1 
r 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralErro 
r 


Unknown error condition 


-2 


UOPNot Allow 
ed 


Operation not allowed by current 
UOP fields 


-3 


NotSupporte 
d 


File type or feature not supported 
at this time 


-5 


NoDisc 


Attempt to play with no disc 



.1,19 InterActual . Stop ( ) 

Summary 

Stops the playback of the current media. Stops 
execution of the current PGC and transfers to the "Stop 
State" . 
Parameters 
None 
required 
Example 

Stop playback of the current DVD. 
InterActual ♦ Stop () 

Media Supported 



DVD 


DVD 


CD 


Video 


Audio 


Audio 
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Return Values 



Numbe 
r 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralErro 
r 


Unknown error condition 


-2 


UOPNot Allow 
ed 


Operation not allowed by current 
UOP fields 


-3 


NotSupporte 
d 


File type or feature not supported 
at this time 


-5 


NoDisc 


Attempt to play with no disc 



. 20 InterActual . Fas tForward (x) 

Summary 

This command fast -forwards the current DVD at speed x. 
Parameters 

x x can range from 2-99; signed 1 

byte integer 

For CD-DA, the number 2-99 
correlates to the number of seconds to 
advance and resume playback. 

Example 

Fast -forwards the current DVD at 8x speed. 
Inter Ac tual . Fas tForward ( 8 ) 

Notes 

Some players may only allow values of 2, 4, 8, 16, and 
32. If this command is used with a value not in the 
list, then the underlying software will approximate to 
the nearest available value (for instance 3 is 
specified and 4 is chosen) rather than return with an 
error code. 
Media Supported 
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DVD 
Video 


DVD 
Audio 


CD 

Audio 


X 


X 


X 



Return Values 



No 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAllowe 
d 


Operation not allowed by current UOP 
fields 


-3 


Not Supported 


File type or feature not supported 
at this time 


-5 


NoDisc 


Attempt to play with no disc 


-6 


ParmRangeErr 


Parameter out of range or invalid 



A . 1 . 2 1 In terAc tual . Rewind (x) 

Summary 

5 Rewind or reverse play the current DVD at speed x. 

Parameters 

x x can range from 2-99; signed 1 byte 

integer For CD -DA, the number 2-99 
correlates to the number of seconds to 
rewind and resume playback. 

Example 

Rewind the current DVD at 8x speed. 
InterActual . Rewind (8) 

10 Notes 

Some players may only allow values of 1, 2, 4, 8, 16, 
and 32. If this command is used with a value not in the 
list, then the underlying software will approximate to 
the nearest available value (for instance 3 is 
15 specified and 4 is chosen) rather than return with an 

error code. 
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Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 


X 


X 


X 



Return Values 



Number 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAllowe 
d 


Operation not allowed by current 
UOP fields 


-3 


Not Supported 


File type or feature not 
supported at this time 


-5 


NoDisc 


Attempt to play with no disc 


-6 


ParmRangeErr 


Parameter out of range or invalid 



22 InterActual .Menu (menuID) 

Summary 

This command jumps to the selected menuID. 
Parameters 

menuID Menu choices for DVD-Video: 

0 : reserved 

1: Title Menu 2: Root Menu 
3 : Chapter Menu 
4: Audio Languages Menu 
5: Sub-picture Languages Menu 
6 : Angle Menu 
Signed 1 byte integer 
w " DVD-Audio does not support a menu ID. 

For DVD-Audio, the Menu method calls the 
Entry PGC in the Audio Manager Menu. 

Example 

DVD-Video: To call the Root Menu of the current VTS 
InterActual .Menu (2) 
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Notes 

All menus are optional and not necessarily present on 
each DVD disc. 
Requires 

DVD-Video: The associated menu UOP must permit the 
operation: Title Menu (UOP10) , Root Menu (U0P11) , Sub- 
picture Menu (U0P12), Audio Menu (U0P13) , Angle Menu 
(U0P14) , Chapter Menu (U0P15) . 

See also: 

InterActual . Resume ( ) 

Media Supported 



DVD Video 


DVD 
Audio 


CD Audio 


X 


X 





Return Values 



Number 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAllowe 
d 


Operation not allowed by current 
UOP fields 


-3 


Not Supported 


File type or feature not 
supported at this time 


-5 


NoDisc 


Attempt to play with no disc 


-6 


ParmRangeErr 


Parameter out of range or invalid 



•1.23 InterActual . Resume ( ) 

Summary 

Resume the playback interrupted by a menu call. 
Parameters 

None required 
Example 

We will resume video or audio playback after a menu 
call. 
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InterAc tual . Resume ( ) 

Notes 

This is called after a Menu command and it is only- 
valid from a Menu. 
5 See also: 

InterActual .Menu (menuID) 
Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 





Return Values 



Number 


Name 


Description 


0 


OK 


Successful 


-1 


General Error 


Unknown error condition 


-2 


UOPNotAllowe 
d 


Operation not allowed by current 
UOP fields 


-3 


Not Supported 


File type or feature not 
supported at this time 


-5 


NoDisc 


Attempt to play with no disc 



U 10 A, 1,24 InterActual ♦StillOffO 

Summary 

This command is the operation to release a Still (VOBU 
Still, Cell Still, PGC Still). 
Parameters 

None required 

15 Example 

The following releases the current still: 

InterActual • StillOf f ( ) 

Notes 

The Still is enforced by the Navigation system, versus 
20 a Pause that is enforced by User Operation. During a 
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Still condition, the count of the Navigation Timer and 
General Parameters in Counter mode are continued as 
usual. However, this is not the case for Pause. 
Additionally, button functions are valid during a Still 
condition - not so for Pause. 
Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 





Return Values 



No. 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAl lowed 


Operation not allowed by current 
UOP fields 


-3 


Not Supported 


File type or feature not 
supported at this time 



• 25 InterActual . SelectUpButton ( ) 

Summary 

Selects the up direction button. 
Parameters 

None 

required 
Example 

Select the "up" direction button on the current menu. 
InterActual . SelectUpButton () 

See also: 

InterActual . SelectDownButton ( ) ; 

InterActual . SelectLef tButton ( ) ; 

InterActual . SelectRightButton ( ) 
Media Supported 
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DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 





Return Values 



Number 


Name 


Description 


0 


OK 


Successful 


-1 


General Error 


Unknown error condition 


-2 


UOPNotAllowe 
d 


Operation not allowed by current 
UOP fields 


-3 


Not Supported 


File type or feature not 
supported at this time 



A. 1 • 26 InterActual • SelectDownButton () 

Summary 

Selects the down direction button. 
Parameters 

None 

required 
Example 

Select the "down" direction button on the current menu. 
InterActual . SelectDownButton ( ) 

See also 

InterActual . SelectUpButton ( ) 

InterActual . SelectLef tButton ( ) 

InterActual . SelectRightButton ( ) 
Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 





15 Return Values 



Number 


Name 


Description 


0 


OK 


Successful 
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10 



-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAllowe 
d 


Operation not allowed by current 
UOP fields 


-3 


Not Supported 


File type or feature not 
supported at this time 



27 InterAc tual . SelectLef tButton ( ) 

Summary 

Selects the left direction button. 
Parameters 

None 

required 
Example 

Select the "left" direction button on the current menu. 
InterAc tual . SelectLef tButton ( ) 

See also 

InterActual . SelectUpButton ( ) 

InterActual . SelectDownButton ( ) 

InterActual . SelectRightButton ( ) 
Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 





Return Values 



Number 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNot Allowed 


Operation not allowed by current 
UOP fields 


-3 


Not Supported 


File type or feature not 
supported at this time 
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A. 1 . 28 InterActual * SelectRightButton ( ) 

Summary 

Selects the right direction button. 
Parameters 
None 
required 

Example 

Select the "right" direction button on the current 
menu. 

InterActual . SelectRightButton () 

See also: 

InterActual. SelectUpButton () ; 

InterActual . SelectDownButton ( ) ; 

InterActual . SelectLef tButton ( ) 
Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 





Return Values 



Number 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAllowe 
d 


Operation not allowed by current 
UOP fields 


-3 


NotSupported 


File type or feature not 
supported at this time 



A. 1 • 29 InterActual . SelectButtonAndActivate (n) 

Summary 

Activate the specified highlighted button, where n is 
the button number. 
Parameters 
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n Number of the button where n may- 

range from 1-36; signed 1 byte 
integer 

Example 

Select button number 2 on the current menu. 
InterActual . SelectButtonAndActivate (2) 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 





Return Values 



Number 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAllowe 
d 


Operation not allowed by current 
UOP fields 


-3 


Not Support ed 


File type or feature not 
supported at this time 


-6 


ParmRangeErr 


Parameter out of range or invalid 



3 0 InterActual . ActivateButton ( ) 

Summary 

Activate the current highlighted button. 
Parameters 
None 

required 
Example 

Activate the currently highlighted button. 
InterActual. ActivateButton () 

Media Supported 



DVD 


DVD 


CD Audio 


Video 


Audio 
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Return Values 



Number 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAllowe 
d 


Operation not allowed by current 
UOP fields 



31 InterActual • SelectAudio (n) 

Summary 

Sets the stream number of the Audio to play. 
Parameters 

n DVD-Video: 

Number of the Audio streams in the Title 
Domain may range 

from 0 to 7 
DVD-Audio: 

The Audio selection may be changed to 0 or 

1 

Signed 1 byte integer 

Example 

Select audio stream number 1. 
InterActual . SelectAudio (1) 

Notes 

The number of audio streams in Menu Domain is, at most, 
1; the author either includes audio in a menu or not. 
Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 





Return Values 



Number 


Name 


Description 


0 


OK 


Successful 
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-1 


General Error 


Unknown error condition 


-2 


UOPNotAllowe 
d 


Operation not allowed by current 
U0P fields 


-3 


Not Supported 


File type or feature not supported 
at this time 


-6 


ParmRangeErr 


Parameter out of range or invalid 



32 InterActual . SelectSubpicture (n) 

Summary 

Sets the stream number of the Sub-picture to display. 
Parameters 

n DVD-Video: 

Number of the Sub-picture streams in the 
Title Domain may 

range from 0 to 31 
DVD-Audio: 

The Sub-picture selection may range from 0 
to 31 

Signed 1 byte integer 

Example 

Select sub-picture number 23. 
InterActual ♦ SelectSubpicture (23 ) 

Notes 

This command is only applicable for the Title Domain. 
Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 





Return Values 



Number 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 
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-2 


UOPNotAllowe 
d 


Operation not allowed by current 
UOP fields 


-3 


Not Support ed 


File type or feature not supported 
at this time 


-6 


ParmRangeErr 


Parameter out of range or invalid 



A . 1 . 33 InterActual * SelectAngle (n) 

Summary 

Sets the angle number of the Angle to play. 
Parameters 

n Angle number n ranging from 1-9/ signed 1 
byte integer 

Example 

Set the angle number to 3 . 
In t er Ac tual . S el ec t Angle ( 3 ) 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 





Return Values 



Number 


Name 


Description 


0 


OK 


Successful 


-1 


General Error 


Unknown error condition 


-2 


UOPNotAllowe 
d 


Operation not allowed by current 
UOP fields 


-3 


Not Supported 


File type or feature not supported 
at this time 


-6 


ParmRangeErr 


Parameter out of range or invalid 



A. 1,34 InterActual . SelectParentalLevel (n) 

Summary 

Selects parental level of the player. 
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Parameters 

n Parental level ranging from 1-8 where 
1 = G 2 = Reserved 3 = PG 4 = PG13 5 = 
Reserved 6 = R 7 = NC-17 8 = Reserved 
Signed 1 byte integer 

Example 

Set the Parental Level to 3 for PG. 
PG = 3; 

InterActual . SelectParentalLevel (PG) 

Notes 

At the start of playback of a DVD, this command can be 
used to select the level and the ParentalEvent will be 
raised. Thus, parents can use this to prevent playback 
of objectionable material. 

This command is only available in Stop State. 
Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 







Return Values 



Number 


Name 


Description 


0 


OK 


Successful 


-1 


General Error 


Unknown error condition 


-2 


UOPNotAllowe 
d 


Operation not allowed by current 
UOP fields 


-6 


ParmRangeErr 


Parameter out of range or invalid 



• 3 5 In t erAc tual • AudioLanguage (x , r c ) 

Summary 

Returns the audio language for specified audio stream 
number x. 
Parameters 

x Audio stream number ranging from 0-7 
Signed 1 byte integer 

86 of 225 



rc Character value; unsigned 2 bytes char 

represented by the coded "Language Symbols" 
defined in ISO-639. See the language codes 
section in the appendix. 

Return Value 



Number 


Name 


Description 


0 


OK 


Successful execution but code not 
specified 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAllowe 
d 


Operation not allowed by current 
UOP fields 


-3 


Not Supported 


File type or feature not 
supported at this time 


-6 


ParmRangeErr 


Parameter out of range or invalid 



Example 

Query the language for audio stream 3 . 
AudioLang3 = InterActual . AudioLanguage (3 ) 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 





3 6 InterAc tual . Audi oLanguageEx tens ion (x) 

Summary 

Returns the audio language extension for specified 
audio stream number x. 
Parameters 

x Audio stream number ranging from 0-7 



Signed 1 byte integer 
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Return Value 

JavaScript Unsigned 1 byte integer 

Number See the language codes extensions 

section in the appendix. 



Number 


Name 


Description 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAllowe 
d 


Operation not allowed by current 
UOP fields 


-3 


Not Supported 


File type or feature not 
supported at this time 


-6 


ParmRangeErr 


Parameter out of range or invalid 



Example 

Query the language extension for audio stream 3. 
AudioLangExt3 = 

InterActual .AudioLanguageExtension (3) 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 





• 37 InterActual • SubpictureLanguage (x, rc) 

Summary 

Returns the sub-picture language for specified sub- 
picture number x (sub-picture language is the 2-digit 
locale) . 
Parameters 

x Sub-picture number ranging from 0-31 

Signed 1 byte integer 
rc Character return value; unsigned 2 bytes char 

represented by the coded "Language Symbols" 

defined in ISO-639. See the language codes 

section in the appendix. 
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Return Value 



Number 


Name 


Description 


0 


OK 


Successful execution but code not 
specified 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAllowe 
d 


Operation not allowed by current 
UOP fields 


-3 


Not Supported 


File type or feature not 
supported at this time 


-6 


ParmRangeErr 


Parameter out of range or invalid 



Example 

Query the locale for sub-picture 3 . 
LocaleSubP23 = InterActual. SubpictureLanguage (3) 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 





• 3 8 InterActual • SubpictureLanguageExtension (x) 

Summary 

Returns the sub-picture language extension for the 
specified sub-picture number x. 
Parameters 

x Sub-picture number ranging from 0-31 
Signed 1 byte integer 

Return Value 

JavaScript Unsigned 1 byte integer 

Number See the language code extensions 

section in the appendix. 



Numbe 


Name 


Description 


r 
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-1 


GeneralErro 
r 


Unknown error condition 


-2 


UOPNot Allow 
ed 


Operation not allowed by current 
UOP fields 


-3 


Not Support e 
d 


File type or feature not supported 
at this time 


-6 


ParmRangeEr 
r 


Parameter out of range or invalid 



Example 

Query the language for sub-picture language extension 
3. 

Lang3Ext = 

*S 5 InterActual . SubpictureLanguageExtension (3 ) 

^ Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 





IB A, 1.39 InterActual . GetGPRM (r ) 

flf 

|I Summary 

IS 10 Gets the specified General Parameter Register value. 

Parameters 

r General Parameter Register Number from 0 to 
15; signed 1 byte integer 

Return Value 
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Signed 4 byte (32 -bit) value in 
the GPRM; 

If the return value is zero (0) or 
any positive number/ it can be 
assumed that the 2 low-order bytes 
are the register contents. If 
this value is negative, it is an 
error condition, which are listed 
below. 



Number 


Name 


Description 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAllowe 
d 


Operation not allowed by current 
UOP fields 


-3 


NotSupported 


File type or feature not 
supported at this time 


-6 


ParmRangeErr 


Parameter out of range or invalid 



^ Example 

1) IBS' 

|0 Get the contents of GPRM(l) 

n s 

3 jl 3 

n X = Inter Ac tual.GetGPRM(l) 

p 5 Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 





A. 1 . 40 InterActual . GetSPRM (r) 

Summary 

Get the specified System Parameter Register value. 
10 Parameters 



JavaScript 
Number 
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SPRM Register Number from 0 to 25; signed 1 byte 
integer 

0: Menu Description Language Code (M_LCD or 
AMGM_LCD) 

1: Audio Stream number (ASTN for TTJDOM, or ASLN 
for TT_GR_DOM) 

2: Sub-picture stream number (SPSTN) and On/Off 
flag for TT_DOM 

3: Angle Number (AGLN for TT_DOM) 

4: Title Nuiriber (TTN for TTJDOM) 

5: VTS Title Number (VTS_TTN for TTJDOM) 

6: Title PGC number (TT_PGC for TTJDOM) 

7: Part_of_Title number (PTTN) for 

One_Sequential_PGC_Title, or PG Number for 

TT_GR_DOM 

8: Highlighted Button number (HL_BTNN) for 

Selection State 

9: Navigation Timer (NV_TMR) 

10: TT_PGCN for NV_TMR 

11: Player Audio Mixing Mode (P_AMXMD) for 
Karaoke 

12: Country Code (CTY_CD) for Parental 
Management 

13: Parental Level (PTL_LVL) 

14: Player Configuration (P_CFG) for Video 

15: Player Configuration (P_CFG) for Audio 

16: Initial Language Code (INI_LCD) for AST 

17: Initial Language Code Extension 

(INI_LCD_EXT) for AST 

18: INI_LCD for SPST 

19: INI_LCD_EXT for SPST 

20: Player Region 

21: A^ Giptj|^|Txamber (ATT_GRN) 

22: ATT number (ATTN for TT_GR_D0M) 

23: Track number (TKN for TT_GRJDOM) 



Return Value 

JavaScript Signed 4 byte (32 -bit) value 

Number stored in the SPRM 

If the return value is zero (0) or 
any positive number, it can be 
assumed that the 2 low- order bytes 
are the register contents* If 
this value is negative, it is an 
error condition, which are listed 
below. 





Number 


Name 


Description 


■5-KSTJ 

& 


-1 


GeneralError 


Unknown error condition 


yj 




UOPNotAllowe 


Operation not allowed by current 


"nf l 


-2 


d 


UOP fields 


'hi 

\ fa 




NotSupported 


File type or feature not 


Z-f " 


-3 




supported at this time 


& 


-6 


ParmRangeErr 


Parameter out of range or invalid 



IS Example 

|j: Get System Parameter Register 1 

13 5 X = InterActual.GetSPRM(l) 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 





A . 1 ♦ 4 1 InterActual . ValidUOP (x) 

Summary 

10 Check if a User Operation is valid. The disabled 

operations are defined on the disc itself. The main 
purpose of this command is to retrieve the current UOP 
status . 

Note: 
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The specific operation (UOP bit) is disabled when the 
corresponding bit is set to a "1". 
Parameters 

Signed 4 byte Bit Assignments: 

(32 -bit) 0 = Time Play, Time Search 

1 s PTT Play, PTT Search 

2 = Title Play 

3 ~ Stop 

4 s Go Up 

5 = Time Search, PTT Search 

6 = Previous PG Search 

7 = Next PG Search 

8 = Forward Scan 

9 = Backward Scan 

10 = Title Menu Call 

11 = Root Menu Call 

12 = Sub -picture Menu Call 

13 = Audio Menu Call 

14 a Angle Menu Call 

15 = Chapter Menu Call 

16 = Resume 

17 = Button Select/Activate 

18 = Still Off 

19 a Pause Off; Pause On 

20 = Audio Stream Change 

21 = Sub-picture Stream Change 

22 = Angle Change; Parental level 
select 

23 « Karaoke Presentation Mode 
Change 

24 = Video Presentation Mode 
Change 

Return Value 
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JavaScript 0 = Permitted 

Number 1 = Prohibited 

Signed 1 byte integer 



Number 


Name 


Description 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAllowe 

a 


Operation not allowed by current 
UOP fields 


-3 


NotSupported 


File type or feature not 
supported at this time 


-6 


ParmRangeErr 


Parameter out of range or invalid 



Example 

To retrieve and test the UOP bit for 
InterActual . PlayTime. 
if (InterActual. ValidUOP (0x01) ) 

f. write ("Time Play is prohibited"); 

else 

f. write ("Time Play is permitted 11 ); 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 





• 4 2 InterActual . Ge tBCAField ( ) 

Summary 

Gets the 2 -byte field from within the BCA for the 

current disc side. 
Parameters 

None required 
Return Value 
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Signed 4 byte (32 -bit) value from 
the BCA; 

If the return value is zero (0) or 
any positive number, it can be 
assumed that the 2 low- order bytes 
are the BCA field contents 
(unencrypted) . These individual bits 
can be used to determine actions 
(like the start-up title) based on 
the specific disc (versus title) . 
If this value is negative, it is an 
error condition, which are listed 
below. 



Numbe 
r 


Name 


Description 


-1 


GeneralErro 
r 


Unknown error condition 


-2 


UOPNotAllow 
ed 


Operation not allowed by current 
UOP fields 


-3 


Not Support e 
d 


File type or feature not supported 
at this time, in this case, the BCA 
is not accessible 



Example 

Query for the BCA field: 

BCA_Test_bits = InterActual .GetBCAField () 

Media Supported 



DVD 

Video 


DVD 
Audio 


CD Audio 


X 


X 





43 InterActual . SupportedFeatures (x) 

Summary 
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JavaScript 
Number 



Use this command to check if features are supported. A 
number is passed in to test a specific feature of the 
API corresponding to the capabilities of the current 
system. A "0" or "1" value is returned specifying if 
the feature is supported or not. If a "1" is returned, 
the corresponding feature is supported and a n 0" means 
it is not supported. 
Parameters 

Signed 1 byte Index number corresponding to the 

command, property or events to be 
tested. See the table following 
for the list of number; ranging 
from 1 - 255 with w 0" being a 
reserved value. 



Return Value 

JavaScript 
Number 



0 = Feature is not available 

1 = Feature is available 
Signed 1 byte integer 



Numbe 
r 


Name 


Description 


-1 


GeneralErro 
r 


Unknown error condition 


-2 


UOPNot Allow 
ed 


Operation not allowed by current 
UOP fields 


-6 


ParmRangeEr 
r 


Parameter out of range or 
invalid 



Example 

To retrieve the supported features for this InterActual 
device: 
ZOOMPAN = 

InterActual . SupportedFeatures (IA_CMDJ200M) 
if (ZOOMPAN) 
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{ 

// can use Zoom... 

} 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 


X 



Index List 

The interfaces are listed below in a form that will be 
used for authoring templates (defined using a w var" 
statement in JavaScript) to avoid having to specify the 
numerical value directly. 

Table 5 (part 1) Supported Features Indices 





Index 


Interface 


value 


DVD-Video & CD-DA Basic 




Reserved 


0 


IA_CMD_Play 


1 


IA_CMD__PiayTitle 


2 


IA_CMD__PlayChapter 


3 


IA_CMD__PlayTime 


4 


IA_CMD_PlayTrack 


5 


IA_CMD_SearchChapter 


6 


IA_CMD_SearchTime 


7 


I A_CMD_S earchTrack 


8 


IA_CMD_TotalNumChapters 


9 


IA_CMD_NextPG 


10 


IA_CMD_PrevPG 


11 


IA_CMD_GoUp 


12 


IA_CMD_NextTrack 


13 
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IA_CMD__PrevTrack 


14 


IA_CMD_TotalTrackTime 


15 


IA_CMD_Pause 


16 


IA__CMD_Stop 


17 


IA_CMD_FastForward 


18 


IA_CMD_Rewind 


19 


IA_CMD_Menu 


20 


IA_CMD_Resume 


21 


IA_CMD_StillOff 


22 


IA_CMD_SelectUpButton 


23 


IA_CMD_SelectDownButton 


24 


IA_CMD__SelectLeftButton 


25 


IA_CMD_SelectRightButton 


26 


I A CMD SelectButtonAm)Activate 


27 


IA_CMD_ActivateButton 


28 


IA_CMD_SelectAudio 


29 


IA_CMD_SelectSubpicture 


30 


IA_CMD_SelectAngle 


31 


IA CMD Select ParentalLevel 


32 


IA_CMD_AudioLanguage 


33 


I A_CMD_Aud IOLANGUAGEEXTENS ION 


34 


IA CMD SubpictureLanguage 


35 


IA_CMD_SubpictureLanguageExtensi 




ON 


36 


IA_CMD_GetGPRM 


37 


IA_CMD_GetSPRM 


38 


IA_CMD_ValidUOP 


39 


IA_CMD_GetBCAField 


40 


IA CMD_SupportedFeatures 


41 


IA_CMD_EnableSubpicture 


42 


IA_CMD_SetGPRM 


43 


IA_CMD_Mute 


44 
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IA_CMD_FullScreen 


45 


IA_CMD_GOTOBOOKMARK 


46 


IA_CMD_SaveBookmark 


47 


IA_CMD_NetConnect 


48 


IA CMD_SubscribeToEvent 


49 


IA CMD_PLAYCHAPTERAUTOSTOP 


50 


IA_CMD_PLAYTIMEAUTOSTOP 


51 


IA_CMD_NetDISConnect 


52 


Reserved 


53 - 59 


IA_PR_EiapsedTime 


60 


IA PR TotalElapsedTime 


61 


IA_PR_TotalTime 


62 


IA_PR_TitleNumber 


63 


IA_PR_PGCNUMBER 


64 


IA PR ChapterNumber 


65 


IA_PR_TrackNumber 


66 


IA_PR_PlayState 


67 


IA_PR_DOMAIN 


68 


IA_PR_AudioNumber 


69 


IA PR SubpictureNumber 


70 


IA_PR_AngleNumber 


71 


IA_PR_ParentalLevel 


72 


IA PR_ButtonNumber 


73 


IA_PR_TotalNumAudio 


74 


IA_PR_TotalTracks 


75 


IA_PR_TotalTitles 


76 


IA_PR_TotalNumSubpicture 


77 


IA_PR_TotalNumAngle 


78 


IA_PR_TotalNumButton 


79 


I A_PR_MajorVers ion 


80 


IA_PR_MinorVersion 


81 


IA_PR_PiayerMode 


82 
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IA_PR_MaxFast 


83 


IA_PR_MaxFastReverse 


84 


IA__PR__MediaID 


85 


IA_PR_DiscType 


86 


IA__PR_BOOKMARK 


87 


IA_PR_ROMType 


88 


IA_PR__InternetStatus 


89 


I A__PR_FullS creenMode 


90 


Reserved 


91 - 99 


IA_EV_TlTLE 


100 


IA_EV_Chapter 


101 


IA_EV_PGC 


102 


IA_EV_Time 


103 


IA_EV_Track_Time 


104 


IA_EV_Track 


105 


IA__EV_Angle 


106 


IA_EV_State 


107 


IA__EV_Speed 


108 


IA__EV_UOP 


109 


IA__EV_Domain 


110 


IA_EV__Audio 


111 


IA_EV_SUBPI CTURE 


112 


IA_EV_Parental 


113 


IA_EV_Region 


114 


IA_EV_Eject 


115 


IA_EV__Insert 


116 


ia_ev_gprm 


117 


IA_EV_lNFO 


118 


IA_EV_RC_Button 


119 


IA__EV_Number_of_Angles 


120 


Reserved 


121 - 129 
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Table 5 (part 2) Supported Features Indices 



DVD-Audio Basic 




IA_CMD_PlayTitleGroup 


130 


IA_CMD__NextSlide 


131 


IA_CMD_PrevSlide 


132 


.Reserved 


133 - 139 


IA PR TitleGroupNumber 


140 


IA_PR_SlideNumber 


141 


Reserved 


142 - 144 


IA_EV_Title Group Event 


145 


IA_EV_Slide Event 


146 


Reserved 


147 - 149 



in Table 5 (part 3) Supported Features Indices 

m 5 



DVD-Video & CD-DA Advanced 




IA_CMD_Open 


150 


IA_CMD_Slow 


151 


IA__CMD_Step 


152 


IA_CMD_SlowReverse 


153 


IA_CMD_Zoom 


154 


IA__CMD__Pan 


155 


IA_CMD_EnableCCText 


156 


IA CMD_MenuLanguage 


157 


IA CMD SelectMenuLanguage 


158 


IA CMD_SelectParentalCountry 


159 


IA_CMDJ3electKaraoke 


160 


I A CMD SetMixVolume 


161 


IA_CMD_Close 


162 


IA_CMD_ShowControls 


163 


IA CMD HideControls 


164 
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IA CMD_ShowContextMenu 


165 


IA_CMD_PopUpMenu 


166 


IA CMD_SuppressErrors 


167 


IA__CMD_AutoMouseHide 


168 


IA_CMD_OpenDrive 


169 


IA_CMD_Launch 


170 


IA_CMD__PresentationMode 


171 


IA_CMD_Print 


172 


ia_cmd_playperiodintitleauto 

STOP 


173 


Reserved 


174 - 189 


IA PR_CurrentMenuLanguage 


190 


IA_PR_TotalNumMenuLanguage 


191 


IA PR_ParentalCountry 


192 


IA__PR_CCTextStatus 


193 


IA_PR_CCText 


194 


IA__PR_MaxSlow 


195 


IA PR MaxSlowReverse 


196 


IA_PR_DiscRegion 


197 


IA_PR_DiscDirectory 


198 


IA PR LocalDirectory 


199 


IA_PR_CurrentZoomX 


200 


IA PR CurrentZoomY 


201 


IA PR CurrentPanX 


202 


IA_PR_CurrentPanY 


203 


IA_PR_MixVolume 


204 


IA_PR_FRAMESPERSECOND 


205 


Reserved 


206 - 220 


IA_EV__Mouse Event 


221 


IA EV Menu Button Event 


222 


IA_EV_Karaoke Event 


223 


IA_EV_Still Event 


224 
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IA_EV_CC Text Event 


225 


IA_EV_FULLSCREEN 


226 


Reserved 


227 - 239 



Table 5 (part 4) Supported Features Indices 



DVD-Audio Advanced 




IA_CMD_HiddenPlayGroup 


240 


IA CMD__HiddenPlayTrack 


241 


IA_CMD__HiddenPlayTime 


242 


IA CMD SelectTextLanguage 


243 


Reserved 


244 - 255 



. 44 InterActual . EnableSubpicture (n) 

Summary 

Enables or disables sub-pictures. 
Parameters 

n If n is 0, then disable Sub-pictures 

(off) 

If n is 1, then enable Sub-pictures 
(on) 

Signed 1 byte integer 

Example 

Disable sub-pictures. 
InterActual .EnableSubpicture (0) 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 





Return Values 



Number Name 



Description 
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0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAllowe 
d 


Operation not allowed by current 
UOP fields 


-3 


Not Supported 


File type or feature not 
supported at this time 


-6 


ParraRangeErr 


Parameter out of range or invalid 



.45 InterActual . SetGPRM (r , x) 

Summary 

Manually set the General Parameter Registers. 
Parameters 

r GPRM Register Number from 0 to 15; signed 1 
byte integer 

x Unsigned 2 byte (16 -bit) value to store in the 
GPRM 

Example 

Set GPRM 1 to 0x0045 
InterActual . SetGPRM ( 1 , 0x0 04 5 ) 

Notes 

This command should be used with caution. 
Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 





Return Values 



Numbe 
r 


Name 


Description 


0 


OK 


Successful 




GeneralErro 


Unknown error condition 


-1 


r 
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-2 


UOPNot Allow 
ed 


Operation not allowed by current 
UOP fields 


-3 


Not Support e 
d 


File type or feature not supported 
at this time 


-6 


ParmRangeEr 
r 


Parameter out of range or invalid 



. 4 6 InterAc tual • Mu te ( ) 

Summary 

Mutes the DVD or CD audio output . 
Parameters 

None 

required 
Example 

With a DVD-video in the drive, mute the DVD-Video 
audio stream. 
InterAc tual • Mute ( ) 
Notes 

This method acts as a toggle. To un-mute, issue 
InterAc tual. Mute () again. 
Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 


X 



Return Values 



Numbe 
r 


Name 


Description 


0 


OK 


Successful 




GeneralErro 


Unknown error condition 


-1 


r 




-2 


UOPNotAllow 
ed 


Operation not allowed by current 
UOP fields 
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Not Support e 


File type or feature not supported 


-3 


d 


at this time 



A • 1 . 47 InterActual . Fullscreen (w) 

Summary 

Sets the video playback to full screen or in a window. 
Parameters 

w When w = 0, set windowed mode when w = 

1, set full screen mode 
Signed 1 byte integer 

Example 

Set to full screen. 
InterActual • Fullscreen (1) 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 





Return Values 



Numbe 
r 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralErro 
r 


Unknown error condition 


-2 


UOPNot Allow 
ed 


Operation not allowed by current 
UOP fields 


-3 


NotSupporte 
d 


File type or feature not supported 
at this time 


-6 


ParmRangeEr 
r 


Parameter out of range or invalid 



A . 1 • 4 8 InterActual . Go toBookmark (b ) 

Summary 

Continues playback at the bookmark saved for this 
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disc* 

Parameters 

b Signed 1 byte integer ranging from 0-32 

Number of the bookmark that is being used for 
resuming the playback, or 

if 0 is passed, resume playback using whatever 
bookmark exists for this disc 

Example 

Play from the bookmark (saved in MyBkMk) saved for 
this disc. 

InterActual . GotoBookmark (MyBkMk) 

Notes 

The bookmarks are assigned a number internally when 
set. A GotoBookmark returns to the same position on 
the disc as when the bookmark was set (saved) . When a 
bookmark is saved, it will overwrite any existing 
bookmark for this disc, should one exist. If all of 
the bookmarks in memory are used, it will overwrite 
the oldest bookmark. Because navigating to other HTML 
pages with embedded video can interrupt playback such 
that other bookmarks can be saved, care should be 
taken to resume playback using the desired bookmark. 
See Bookmarks in the appendix for a detailed layout of 
bookmarks . 

If the bookmark number is not known by the JavaScript, 

passing a parameter of 0 will use the last bookmark 

that was saved for this disc. 
See also 

InterActual . SaveBookmark ( ) 
Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 


X 
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Return Values 



Number 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAllowe 
d 


Operation not allowed by current 
UOP fields 


-5 


NoDisc 


Attempt to play with no disc 


-6 


ParmRangeErr 


Parameter out of range or invalid 


-8 


IncorrectDis 
c 


The bookmark specified is not for 
this disc 



. 4 9 InterActual . SaveBookmark ( ) 

Summary 

Saves a bookmark for the current play location for 
this disc. 
Parameters 

Return Value 

JavaScript Signed 1 byte integer ranging from 

Nuxriber 1-32 number of the bookmark that 



is being saved 



Numbe 
r 


Name 


Description 


-1 


GeneralErro 
r 


Unknown error condition 


-2 


UOPNot Allow 
ed 


Operation not allowed by current 
UOP fields 


-5 


NoDisc 


Attempt to play with no disc 



Example 

Save a bookmark for this disc and call it MyBkMk. 
MyBkMk = InterActual • SaveBookmark () 

Notes 

When a bookmark is saved, it will overwrite any 
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existing bookmark for this disc, should one exist. If 
all of the bookmarks in memory are used, it will 
overwrite the oldest bookmark. See Bookmarks in the 
appendix for a detailed layout of bookmarks. 

See also 

GotoBookmark (b) 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 


X 



vPI 10 



in 

m 



M 
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A • 1 . 5 0 InterAc tual . NetConnec t ( ) 

Summary 

Establish an Internet connection. 
Parameters 
None 
required 
Example 

Open connection. 
InterAc tual .NetConnect () 
Media Supported 



20 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 


X 



Notes 

This command does not block, but when it is used in 
conjunction with the Net Event, the code can see the 
progress of establishing a connection and respond 
accordingly. 
Return Values 



Number 


Name 


Description 




0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 
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-3 


NotSupporteci 


File type or feature not 
supported at this time or not 
possible at this time 


-7 


MemoryErr 


Not enough memory for operation 



. 51 InterActual .NetDisconnect () 

Summary 

Inform the underlying system that an Internet 
connection is no longer required. The system setup 
parameters will determine whether to actually 
disconnect a session or not based on the system 
configuration. 

Parameters 
None 
required 

Example 

Open connection. 
InterActual ♦NetDisconnect () 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 


X 



Notes 

This command does not block. 
Return Values 



Number 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 


-3 


Not Supported 


File type or feature not 
supported at this time or not 
possible at this time 


-7 


MemoryErr 


Not enough memory for operation 

— ' 
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. 52 InterActual . SubscribeToEvent (e, s) 

Summary 

All events listed in the base API are subscribed to, 
by default with the exception of "Info" event, index 
n 21" . Additionally, all advanced and platform-specific 
events are not subscribed to and must be explicitly 
subscribed to. A program can choose to subscribe or 
unsubscribe to an event using this command. 
Parameters 

e Event id, which is the index number as 

listed in the Event section of this 
document; it can range from 0-999; 
Signed 2 -byte integer. 

s Subscription flag where s=0 means 

unsubscribe and s=l means to subscribe 
to the event id contained in e; 
Signed 1 byte integer. 

Example 

To subscribe to the Karaoke event: 
InterActual . SubscribeToEvent (52,1) 

Notes 

If an attempt is made to subscribe to an event that is 
already subscribed to (for whatever reason) , no error 
will be returned; rather the state of subscription 
will not change 
Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 


X 



Return Values 



Number 


Name 


Description 


0 


OK 


Successful 
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-1 


GeneralErro 
r 


Unknown error condition 


-3 


NotSupporte 
d 


File type or feature not supported 
at this time, in this case the 
event type is not supported on 
this platform. 


-6 


ParmRangeEr 
r 


Parameter out of range or invalid 


-7 


MemoryErr 


Not enough memory for operation 



A. 2 Properties 

JS Properties can be used to find information about commonly used 

vC 5 variables, such as time, title and chapter. They are read-only, 
fp by definition. Where it makes sense to set a specific property, 

^ there will be an associated command to do so. 

•f f 5 

^ All properties must be supported and contain a value within the 

f| 10 range specified. If a property doesn't exist or is not 

; U supportable at the time, then the property should return the 

b value "not implemented" or w ni" for character or "-1" for 

? " numeric values. 

InterActual playback devices shall support the following 

15 properties. 

A. 2.1 InterActual . ElapsedTime 

Summary 

Returns the elapsed time of the current title, or the 
20 current track for CD-DA, in milliseconds. 

Return Value 

JavaScript Signed 4 byte (32 -bit) integer 
Number ranging from 0 to 2 31 -1 

Example 
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Query the elapsed time so far. 
TimeSoFar « InterActual .ElapsedTime 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 


X 



2 InterActual . TotalElapsedTime 

Summary 

Returns the total elapsed time, in milliseconds, of 
the CD-DA (disc) playing. 
Return Value 

JavaScript Signed 4 byte (32 -bit) integer 

Number ranging from 0 to 2 31 -1 

Example 

Query the elapsed time of the CD playing. 
DiscLength = InterActual. TotalElapsedTime 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 






X 



• 3 InterActual . To talTime 

Summary 

Returns the total time of current title (in 
milliseconds) . For CD-DA, it returns the total time 
for the current disc. 
Return Value 

JavaScript Signed 4 byte (32 -bit) integer 
Number ranging from 0 to 2 31 -1 

Example 

Query the length of the current title. 
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TitleLength = InterActual. TotalTime 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 


X 


X 


X 



4 Inter Actual ♦ Ti tleNumber 

Summary 

Returns the currently playing title number. 
Return Value 

JavaScript Signed 1 byte integer ranging from 

Number 1-99 

Example 

Query the current title number. 
TitleNuxn = InterActual.Ti tleNumber 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 







5 InterActual • PGCNumber 

Summary 

Returns the currently playing PGC number. 
Return Value 

JavaScript Signed 2 byte integer ranging from 

Number xx l" to *2 15 -l" 

Example 

Query the current PGC number for the current menu or 
title space. 

CurrPGCNuxn - InterActual . PGCNumber 

Media Supported 
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DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 





6 Inter Actual . ChapterNumber 

Summary 

Returns the currently playing chapter number. 
Return Value 

JavaScript Signed 2 byte integer ranging from 

Number 1 - 999 

Example 

Query the current chapter number. 
Cur r Chap terNum = InterActual. ChapterNumber 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 







7 Inter Ac tual . Tr ackNumber 

Summary 

Returns the currently playing track number. 
Return Value 

JavaScript Signed 1 byte integer ranging from 

Number 1-99 
Example 

Query the current track number. 
FavoriteTrackNum = InterActual .TrackNumber 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 




X 


X 
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8 InterActual . PlayState 

Summary 

Returns the current play state. 
Return Value 

JavaScript Signed 1 byte integer ranging from 

Number 0-7 where: 

0: Uninitialized 

1: Play 

2 : Pause 

3: Stop 

4: Scanning Forward 

5: Scanning Backward 

6: Slow Forward Play 

7: Slow Backward Play 

the values 6 & 7 don't apply to 

CD-DA 

Example 

Query the current play state. 
State a InterActual. PlayState 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 


X 



. 9 InterActual . Domain 

Summary 

Returns the current domain. 
Return Value 
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JavaScript Signed 1 byte integer ranging from 

Number 1-8 where: 

1: First Play Domain 

2 : Video Manager Menu Domain 

3 : Audio Manager Menu Domain 

4 : Video Title Set Menu Domain 

5: Title Domain 

6: Title Group Domain 

7: Stop State 

8: Decoder Shutdown (computer 
only) 

Example 

Query the current domain. 
currentDom = InterActual* Domain 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 





A . 2 . 10 InterAc tual * AudioNumber 

Summary 

Returns the current audio stream/selection number. 
Return Value 

JavaScript Signed 1 byte integer 

Number DVD-Video: 

Number of the Audio streams 
in the Title Domain may 
range from 0 to 7 
DVD-Audio: 

The Audio selection may be 
changed to 0 or 1 

Example 

Query the current audio stream/selection number. 
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audioStreamNumber = Inter Ac tual.AudioNumber 

Notes 

For DVD-Audio, only 1 audio stream is available in the 
DVD-Audio zone. On a hybrid disc, the DVD-Video zone 
can have a max of 2 audio streams. 
Media Supported 



DVD Video 


DVD 
Audio 


CD Audio 


X 


X 





A. 2 . 11 InterActual • SubpictureNumber 

Summary 

Returns the current sub-picture stream number. 
Return Value 

JavaScript Signed 1 byte integer ranging from 

Number 0-31 

Example 

Query the current sub-picture stream number. 
SubP = InterActual •SubpictureNumber 

Notes 

If this property returns a ninety-nine (99) , then sub- 
pictures are off. 
Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 





A. 2 .12 InterActual -AngleNumber 

Summary 

Returns the current video angle. 
Return Value 
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JavaScript Signed lbyte integer ranging from 

Number 1-9 

Example 

Query the current video angle. 
CurrAngle = InterActual .AngleNumber 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 







13 InterActual.ParentalLevel 

Summary 

Returns the current parental level . 
Return Value 

JavaScript Signed 1 byte integer 

Number Parental level ranging from 1-8 

where 

1 = G 2 = Reserved 3 = PG 4 = PG13 5 
= Reserved 6 = R 7 = NC-17 8 = 
Reserved 

Example 

Query the parental level . 
CurrPlvl = InterActual.ParentalLevel 

Notes 

Upon the start of playback, this property can be 
tested to avoid playback of material at a higher level 
than parents may allow* 
Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 







14 



InterActual . ButtonNumber 
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Summary 

Returns the number of the currently highlighted 
button. 
Return Value 

JavaScript Signed 1 byte integer ranging from 

Number 1-36 

Example 

Query the number of the currently highlighted button 
on the menu* 

SelectedButton = InterActual .ButtonNumber 

Notes 

Up to 36 rectangular buttons can be on the screen 
(which are capable of being highlighted) . In the case 
of wide screen content (with anamorphic, auto- 
letterbox, or auto pan & scan modes) , only 18 buttons 
are allowed per screen (when two modes are used) . Only 
12 buttons are allowed per screen when all three modes 
are used. 
Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 





A. 2. 15 InterActual. TotalNumAudio 

Summary 

Returns the total number of audio streams available 
for current title/title group. 
Return Value 

JavaScript Signed 1 byte integer 

Number DVD-Video: ranging from 0-8; 0 

means no audio 

DVD-Audio: ranging from 0-1 

Example 
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Query the total number of audio streams in the 
title/title group. 

TotalTracksAudio = XnterActual . TotalNumAudio 

Notes 

For DVD-Audio, only 1 audio stream is available in the 
DVD-Audio zone. On a hybrid disc, the DVD-Video zone 
can have a max of 2 audio streams . 
Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 





A . 2 * 16 InterAc tual . To talTracks 

Summary 

Returns the total number of audio tracks available for 
current CD -DA disc. 
Return Value 

JavaScript Signed 1 byte integer ranging from 

Number 1-99 
Example 

Query the total number of audio tracks on this CD -DA 
disc. 

TotalTracksOnDisc = InterActual •TotalTracks 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 






X 



A . 2 . 17 InterActual . TotalTitles 

Summary 

Returns the total number of titles available for 
current disc. 
Return Value 
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JavaScript Signed 1 byte integer ranging from 

Number 1-99 
Example 

Query the total number of titles on this disc. 
TotalTitlesOnDisc a InterActual .TotalTitles 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 





A. 2 • 18 InterActual . TotalNumSubpicture 

Summary 

Returns the number of sub-picture streams currently 
available. 
Return Value 

JavaScript Signed 1 byte integer ranging from 

Number 0-31; 0 means none are available 

Example 

Query the number of sub-picture streams available. 
TotalAvailSubP a InterActual .TotalNumSubpicture 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 





A* 2 . 19 InterActual . TotalNumAngle 

Summary 

Returns the total number of available angles. 
Return Value 

JavaScript Signed 1 byte integer ranging from 

Number 1-9 

Example 

Query the total number of available 
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angles. 

TotalAvailAngles - InterActual.TotalNumAngle 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 







A. 2 ,20 InterActual.TotalNumButton 

Summary- 
Returns the total number of buttons on the current 
menu. 

Return Value 

JavaScript Signed 1 byte integer ranging from 

Number 0-36; 0 means none (no buttons 

on this menu; the user must use 

xy next" to advance) 

Example 

Query the number of buttons on the current menu. 
TotalAvailButtons ■ InterActual.TotalNumButton 

Notes 

Up to 36 rectangular buttons can be on the screen 
(which are capable of being highlighted) . In the case 
of wide screen content (with anamorphic, auto- 
letterbox, or auto pan & scan modes) , only 18 buttons 
are allowed per screen (when two modes are used) . Only 
12 buttons are allowed per screen when all three modes 
are used. 
Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 





A. 2. 21 



Inter Ac tual . Ma j orVersion 
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kJ 

if s 

m 

%y ; 

n 

f'fe 

m 
h 



10 



15 



20 



Summary 

This property returns the platform major version (e.g. 
if the API version is 1.03, it will return MajorVersion 



as 



This field can also be used to determine the 



parsing of certain bits in 
InterActual . SupportedFeatures. 
Return Value 

JavaScript Returns major version unique to 

Number each playback system; signed 2 

byte integer 

Example 

Query the major version of InterActual API for the 
current device. 

API_MajorVers = InterActual • MajorVersion 
If API_MajorVers > 1 ... 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 


X 


X 


X 



A. 2 . 22 InterActual ♦MinorVersion 

Summary 

This property returns the platform minor version (e.g. 
if the version is 1.03, it will return *03" for 
MinorVersiori) . This field can also be used to determine 
the parsing of certain bits in 
InterActual . SupportedFeatures . 
Return Value 
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JavaScript Returns minor version unique to each 

Number playback system; signed 2 byte 

integer . 

There are 2 digits to the minor 
version and they are both important. 
Since the property returns a number, 
this is how the number must be 
interpreted by any JavaScript 
programmer: 



Return Value Version 

0 x.00 

1 x.01 

2 x.02 

3 x.03 

4 x.04 

5 X.05 

6 x.06 

7 x.07 

8 x.08 

9 x.09 

10 x.10 

11 x.ll 

30 x.30 
,„and so forth. 



Example 

Query the minor version of InterActual API for the 
current device. 

API_MinorVers as InterActual .MinorVersion 
If API_MinorVers > 5 ,„ 

Media Supported 
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DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 


X 



A. 2. 23 InterActual. PlayerMode 

Summary 

This property returns the default mode for playback of 
discs as configured by the system's configuration 
application. 

If this is InterActual mode, then the system will play 
it as authored launching INDEX . HTM (see the API 
Directory Structure appendix for details) . If the user 
specifies that the system should play discs in Play 
mode, then this will override how the disc was authored 
and always start in linear movie playback. 
Return Value 

Char string Returns a signed 32 byte value of 
the player mode in characters, 
either "Play" or "InterActual" 

Example 

Query the player mode of InterActual API for the 
current device. 

mode = InterActual* PlayerMode 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 


X 



A. 2. 24 InterActual. MaxFast 

Summary 

Returns the maximum number of fast speeds. 
Return Value 

127 of 225 



JavaScript Signed 1 byte integer Number of 

Number fast speeds ranging from 0-99 

Example 

Get the total number of fast speeds supported, 
x = InterActual .MaxFast 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 


X 


X 





A. 2,25 InterActual. MaxFastReverse 

Summary 

Returns the maximum number of reverse fast speeds. 
Return Value 

JavaScript Signed 1 byte integer Number of 

Number reverse fast speeds ranging from 0 

- 99 

Example 

Get the total number of reverse fast speeds supported, 
x » InterActual .MaxFastReverse 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 


X 


X 





A.2.26 InterActual. MedialD 

Summary 

Returns a unique identifier for the current disc side. 
Return Value 
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Char string A 128-bit unique media (title) 

identifier that is translated into a 
hex character string in the same 
fashion as a Windows GUID, e.g. 
"A073 9DE5571FllD2A0310060977F760C n 



This pattern is 32 hexadecimal 
characters . 

Example 

Query for the unique disc identifier: 
discID = InterActual .Media ID 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 


X 


X 


X 



A. 2. 27 InterActual. DiscType 

Summary 

The DiscType property returns the disc format to the 
application. 
Return Value 
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IB 
Id 



III 

n 



JavaScript 
Number 



Signed 1 byte integer 0 - 255. A 
disc may be only one of the 
following types: 

0: drive is empty or in an unknown 
state 

1 : CD-Audio 

2: DVD-Video only 

3: DVD-Video and CD -DA 

4: DVD-Audio only 

5: DVD-Audio and CD-DA 

6: DVD-Audio and DVD-Video 

7: DVD-Audio and DVD-Video & CD-DA 

8-255: reserved 
Note: some of these hybrid 
combinations may not exist in the 
market at this time. 



Example 

Query the disc media type: 
disclnfo m InterActual.DiscType 

Media Supported 



DVD 


DVD 


CD 1 


Video 


Audio 


Audio 


X 


X 


X 



10 



A . 2 • 2 8 Inter Ac tual . Bookmark 

Summary 

Returns the number of the bookmark for the current disc 
if it has been saved. 
Return Value 

Signed 1 byte integer ranging from 
1-32 will return 0 if there is 
no bookmark saved. 



JavaScript 
Number 



Example 
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Query the bookmark for the current disc if there is 
one. 

CurBkMk = InterActual* Bookmark 

If (CurBkMk == MyBkMk) // test to see if its 
mine 

InterActual . GotoBookmark 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 


X 


X 


X 



2 9 InterActual . ROMType 

Summary 

The ROMType property queries the type of ROM data that 
is contained on the DVD (e.g. the format of the HTML 
tags and JavaScript calls) . 
Return Value 

JavaScript Signed 1 byte integer 0 - 255. The 

Number ROM type may be only one of the 

following types: 

0 = No DVD-ROM data present 

1 = Unknown DVD-ROM material 
present 

2 = PCFriendly 

3 = InterActual API 

4 = InterActual Player Only 
(computer only) 

5 - 255 = reserved 

Example 

Query the ROM type: 
ROMInfo = Inter Actual. ROMType 

Notes 

The mechanism for setting these bits is to be as 
131 of 225 



follows : 

- For DVD-ROM material, test to see if there is any 

file in the main directory other than those in the 
VIDEO_TS and AUDIO_TS and JACKET _P directories, 

- For PCFriendly, test to see if the DISC. ID file is 

present in the root directory, and the section 
heading [PCFriendly] exists. 

- For InterActual compatibility, test to see if the 

COMMON\INDEX.HTM file is present (or INDEXI.HTM - 
see the API Directory Structure appendix) and read 
the HTML meta-data to determine the minimum 
required API version for the ROM content (see the 
Appendix describing Meta data information) . 

- For InterActual Player Only, test to see if the 

DISC. ID file is present in the root directory, and 
the section heading [InterActual] exists, then be 
sure there are no files named INDEX*. HTM in the 
COMMON directory. 
Other data and programs may be on the discs as well, 
for instance, a Macintosh PCFriendly disc may contain 
platform specific code. It will be classified as 
PCFriendly if it meets the requirements above. 
Media Supported 



DVD 
Video 


DVD 

Audio 


CD 

Audio 


X 


X 


X 



30 InterActual , Internets tatus 

Summary 

Returns the current Internet connection status. 
The list of return values is exhaustive to allow for a 
fine granularity of possibilities across the various 
platforms supported (computers, game machines and set 
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top players) . Hence, a device could be built with no 
connectivity option whatsoever, only rendering HTML and 
JavaScript from local sources, e.g. the disc ROM. 
Additionally, a device may offer an after- sale option 
to add connectivity through a network module or MODEM. 
Return value "1" would cover this situation where the 
system is capable of connecting, but the option is not 
installed. Return value "2" would cover the situation 
where a network session (PSTN or LAN, etc) is not 
currently established. A u 3" would be returned while a 
connection is being established or if a connection has 
dropped is being re-established by the system. 
Additionally, some platforms may have no reliable 
method to establish the connection speed and return 
only a M" . 
Return Value 
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Signed 1 byte integer Connection 
status as follows: 

0 = no connectivity option 
available, ever 

1 = connectivity option not 
currently installed 

2 = connectivity option installed, 
not online (offline) 

3 = connectivity option installed, 
status unknown 4 = online, speed 
unknown 



10 


= up to 28K 


11 


= up to 56K 


12 


= up to 128K 


13 


= up to 1 . 5M 


14 


= up to 10M 


15 


= up to 100M 


16 


= greater than 100M 



others reserved 

Example 

Query the Internet status. 

ConnectStatus = interActual.InternetStatus 

Media Supported 



DVD Video 


DVD 
Audio 


CD Audio 


X 


X 


X 



.31 InterActual . FullScreenMode 

Summary 

Returns the current state of full screen mode. 
Return Value 



JavaScript 
Number 
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0 



Ms 



JavaScript Signed 1 byte integer Status as 

Number follows: 

0 = not in full screen mode 

1 = in full screen mode 

Example 

Query the full screen mode status, 

FullScreenModeStatus = InterActual.FullScreenMode 

Media Supported 



DVD Video 


DVD 
Audio 


CD Audio 


X 


X 


X 
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A. 3 Events 

Events are integral to synchronizing DVD-Video with other media. 
With these events, web pages can be synchronized with the audio 
or video. For example, each ChapterEvent (start of new chapter) 
can trigger an HTML storyboard that corresponds to the movie. 
Time based events can be used to coordinate advertising messages 
in HTML while the video is playing: when James Bond is driving 
his BMW, an appropriate web page (BMW or auto sales site) can 
automatically be displayed at the same time. 

The value of events is that these external media do NOT have to 
be embedded or even be known at the time the DVD-Video is 
authored. This flexibility keeps DVD-Video authoring on schedule 
and greatly minimizes the authoring costs while adding valuable 
and unique features to each disc. 

Events can be used by the calling application (HTML/ JavaScript , 
C++, or other) to receive notification of DVD playback status. 
There is an EventHandler function required which will switch on 
the event type index (see below) and call the appropriate 
function. If a platform does not support an event, then an error 
code must be returned when its use is attempted. Here is an 
example of an event handler in JavaScript: 

<OBJECT ID= H Inter Actual" 

CLASSID="clsid:A0739DE5-571P-llD2- 

A0310060977F760C" 

BORDER= "l" WIDTH=50% HEIGHT=60% > 

</OBJECT> 

<SCRIPT LANGUAGE*" JavaScript »> 

function EventHandler ( index , parml , parm2 , parm3 ) 

{ 

swi tch ( index) ! 

{ 

case 0: //reserved 
break; 
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case 1: //title event 

TitleEvent (parml) ; 

break; 
case 2 t //chapter event 

ChapterEvent (parml) ; 

break; 
case 3://PGC event 

PGCEvent (parml) ; 

break; 
case 4: //Time event 

TimeEvent (parml, parm2) ; 

break; 

// etc.. - see index list below 
default: 

UnknownEvent (parml , parm2 , parm3 ) ; 
break; 

} 

} 

// The following is the private function that will 
take 

// parameters 1 and 2 which are elapsed and total 
time. 

// The name is up to the author, but must match the 
case 

// statement in the Event Handler routine • 
function TimeEvent (elapsedTime, totalTime) 
{ //Synchronize my graphic at 15 seconds 

if (elapsedTime « 15000) 
document . images [0] .src = "bmw.gif 11 
} 

</SCRIPT> 

The following table lists the event indices that will be 
generated by the browser. There is a skip in the enumeration for 
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advanced events and platform-specific events. We have reserved 
unique events for specific platforms like the PC or Macintosh. 

There is a command enabling subscribing to events or 
unsubscribing to events (see Interactual . SvbscribeToEvent listed 
in the command section) . 

Note: By default, all events listed in the base API 
are subscribed to with the exception of 
The Info event (index 21) 
The RC Button event (index 22) and 
The Net event (index 24) . 
In addition to these events, all advanced and 
platform- specific events are not subscribed to and 
must be explicitly subscribed to* 

The table lists event the index and which parameter is returned. 
The details for each event type and associated parameters follow, 
however TitleGroup and Slide are described in the DVD-Audio 
section of this document, as they are specific to DVD-Audio only. 

Table 6 Event Indices 





Index 








Event Type 


value 


Parml 


Parm2 


Parm3 


Reserved 


0 








Title 


1 


titleNum 






Chapter 


2 


chapterN 
um 






PGC 


3 


pgcNum 






Time 




elapsedT 


totalTim 






4 


ime 


e 




TrackTime 






elapsedT 


totalTim 




5 


trackNum 


ime 


e 


TitleGroup 


6 


groupNum 
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I 



I Track * 


f t 


:rackNum 




Slide I 




slideNum 




Angle ! 


? * 


angleNum 




1 State 


10 


stateNum 




1 Speed 


11 


speedNum 




UOPs 


12 


uopField 
s 




Domain 


13 


domainNu 
m 




Audio 


14 


audioNxim 




1 Subpicture 


15 


subpictu 
reNum 




1 Parental 


16 


parental 
Num 




Region 


17 


regionNu 
m 




I Eject 


18 






Insert 


19 






GPRM 


20 


regNum regVal 




Info 


21 






RCButton 


22 


rcButton 




NuxaAngles 


23 


totalNum 




Net 


24 


NetState 
Num 




Keserved 


25 






Advanced 
Events 








Mouse 


50 


MouseBut 
ton J x 


y 


Menu 
j Button 


51 
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Karaoke 


52 


KaraokeN 
uxn 






Still 


53 


State 






CC Text 


54 


CcText 






Platform 
Specific 










PC 


"1 A A 1 1 A 

100 - 110 








Fullscreen. 


1UU 


Transiti 
on 






Mac into sn 


TIT T O n 

111 — 120 








Linux 


TOT -1 «*> A 

121 - 130 








Nuon 


T *5 T 1 >f A 

131 - 140 








Nintendo 


141 - 150 








Sega 


131 "■ lOU 








Sony 


161 - 170 








X Box 


171 - 180 








Reserved 


181 - 190 








Reserved 


191 - 200 









The following list of InterActual API events must be supported 
and the number and meaning of the parameters they will receive is 
detailed. For example, the title event is index number 1 and a 
private function (such as TitleEvent) will receive one parameter 
(the others will be null) and it will be the new title number 
(see below for an explanation) . 

Sample private event functions: 

A. 3.1 Title Event 

Summary 

Called when the title changes. Returns the new title 



140 of 225 



number in titleNum. 
Return parameters 

titleNum Signed 1 byte integer ranging 

from 1-99 

Example 

Trigger an event when playback reaches Title 3 : 
<SCRIPT LANGUAGE^ " JavaScript 11 > 
function TitleEvent (titleNum) 
If (titleNum » 3) 

{ 

// Perform function once Title 3 has been 
trapped 

} 

</SCRIPT> 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 


X 


X 





.2 Chapter Event 

Summary 

Called when the chapter changes. Returns the new 
chapter number in chapterNum. 
Return parameters 

chapterN Signed 2 byte integer 
um Chapter index ranging from 1-99 for 

One_Sequential_PGC_Title 
Chapter index ranging from 1 - 999 for 
Multi_PGC_Title 

Example 

Trigger an event when playback reaches chapter 2 of 
Title 1: 

<SCRIPT LANGUAGES 11 JavaScript" > 
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function Chap terEvent (chap terNum) 
If (chap terNum 2) { 

// Trigger event once in Chapter 2 

} 

</SCRIPT> 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 


X 







o 



A. 3.3 PGC Event 

Summary 

10 Called when the PGC changes. Returns the new PGC 

number in PGCNum* 
Return parameters 

PGCN Signed 2 byte integer ranging from 1 to 2 15 -1 
um 
Example 

Trigger an event when playback reaches PGC 2 of Title 
15 1: 

< SCRIPT LANGUAGE* "JavaScript" > 
function PGCEvent (PGCNum) 
If (PGCNum == 2) { 

// Trigger event once in PGC 2 

20 } 

</SCRIPT> 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 


X 







A. 3. 4 Time Event 

25 Summary 



142 of 225 



Called on a time change. Returns the elapsed time and 
total time, both in milliseconds. 
Return parameters 

elapsedTi Elapsed time, signed 4 byte (32 -bit) 
me integer ranging from 1 to 2 31 -1 

totalTime Total time, signed 4 byte (32 -bit) 
integer ranging from 1 to 2 31 -1 
(~2 24 is the practical limit) 

Example 

Trigger the display of a graphic when playback reaches 

15 seconds of Title 1: 
<SCRIPT LANGUAGE*" JavaScript" > 
function TimeEvent (elapsedTime, totalTime) 
if (elapsedTime == 15000) 

{ 

document. images [0] .src = "bmw.gif" 

//Display my graphic at 15 

seconds 
} 

</SCRIPT> 

Notes 

This event should trigger approximately every 900 
milliseconds while in play mode. 
Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 


X 


X 


X 



.5 Track Time Event 

Summary 

Called on a time change within the context of a CD 
track. Returns the elapsed time and total time (both 
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in 

£ 

?-fflSJ 

f "5 



10 



15 



20 



in milliseconds) ♦ 
Return parameters 

trackNum Track number associated with this time 
event signed 1 byte integer ranging 1- 
99 

elapsedTi Elapsed time into track, signed 4 byte 
me (32 -bit) integer ranging from 1 to 2 31 -1 

totalTime Total time into track, signed 4 byte 

(32 -bit) integer ranging from 1 to 2 31 -1 
(~2 24 is the practical limit) 

Example 

Trigger the display of a graphic when playback reaches 

15 seconds into CD track 4 ; 
< SCRIPT LANGUAGE^ "JavaScript" > 
function TrackTimeEvent (trackNum, elapsedTime, 
totalTime) 

if (trackNum == 4} && (elapsedTime == 15000) 

{ 

document, images [0] .src = "PhilKeaggy *gif 11 
//Display graphic at 15 

seconds 
} 

</SCRIPT> 

Notes 

This event should trigger approximately every 900 
milliseconds while in play mode. 
Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 






X 



A. 3 ,6 Track Event 

Summary 
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Called when the track changes. Returns the new track 
number in trackNum. 
Return parameters 

trackNum Signed 1 byte integer ranging from 1 - 
99 

Example 

Trigger an event when playback reaches track 5 : 
<SCRIPT LANGUAGE= n JavaScript »> 
function TrackEvent (trackNum) 
If (trackNum == 5) { 

// Trigger event once in Track 5 

} 

</SCRIPT> 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 




X 


X 



•7 Angle Event 

Summary 

Called on angle change. Returns the new angle number 
angleNum. 
Return parameters 

angleNum New angle number, signed 1 byte 
integer ranging from 1-9 

Example 

Trigger an event when angle number 3 is selected: 
<SCRIPT LANGUAGE=" JavaScript" > 
function AngleEvent (angleNum) 
if (angleNum == 3) 

{ 

// Trigger event once angle 3 is reached 

} 
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</SCRIPT> 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 


X 







•8 State Event 

Summary 

Called on state change, e.g. when the play state 
changes from play to pause. 
Return parameters 

stateNum State number, signed 1 byte integer 
ranging from 0-7 
0: None 
1: Play 
2 : Pause 

3 : Stop 4 ; Scanning Forward 

5 : Scanning Backward 6 : Slow Forward 

Play 

7: Slow Backward Play 

Example 

Trigger an event when playback is paused: 
<SCRIPT LANGUAGE= "JavaScript" > 
function StateKvent (stateNum) 
if (stateNum == 2) 

{ 

// Trigger event base on pause 

} 

</SCRIPT> 

Media Supported 



DVD 


DVD 


CD 


Video 


Audio 


Audio 
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X 



,9 Speed Event 

Summary 

Called on speed change, e.g. when changed from play to 
scanning. Returns the new speed information. 
Return parameters 

speedNum Speed number, signed 1 byte integer 
ranging from 1-99 

Example 

Trigger an event when speed is changed: 
<SCRIPT LANGUAGE= 11 JavaScript" > 
function SpeedEvent (speedNum) 
if (speedNum « 8) 

{ 

// Trigger event upon speed transition to 8x 

} 

</SCRIPT> 

Media Supported 



DVD 
Video 


DVD 

Audio ! 


CD 

Audio 


X 


X 





,10 UOP Event 

Summary 

Called when any UOP changes. Returns the new UOP 
fields. 
Return parameters 

uopFields UOP fields; signed 4 byte (32-bit) 
number (see the command 
Inter Actual. ValidUOP for the list) 

Example 

Trigger an event when PlayTime UOP is prohibited: 
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<SCRIPT LANGUAGE=" JavaScript" > 
function UOPEvent (uopFields) 
if (uopFields & 0x00000001) { 

// Display disabled state of 
// PlayTime graphic since playback is 
prohibited 

} 

</SCRIPT> 



Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 


X 







• 11 Domain Event 

Summary 

Called when the domain changes. Returns the new domain 
number * 
Return parameters 

domainNum Signed 1 byte integer Domain number 
ranging from 1-8: 
1: First Play Domain 
2 : Video Manager Menu Domain 
3 : Audio Manager Menu Domain 
4: Video Title Set Menu Domain 
5: Title Domain 
6: Title Group Domain 
7: Stop State 

8; Decoder Shutdown (computer only) 

Example 

Trigger an event when domain changes to Title domain: 
<SCRIPT LANGUAGE- "JavaScript" > 
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function DomainEvent (domainNum) 
if (domainNum == 5) 

{ 

// Trigger event on title domain change 

} 

</SCRIPT> 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 


X 


X 





• 12 Audio Event 

Summary 

Called when there is a change in the audio stream 
number. Returns the new audio number in audioNum, 
Return parameters 

audioNum Audio stream number, signed 1 byte 
integer ranging from 0-7 

Example 

Trigger an event when audio stream changes : 
<SCRIPT LANGUAGE* "JavaScript" > 
function AudioEvent (audioNum) 
if (audioNum == 4) 

{ 

// Trigger event based on audio stream change 
to stream 4 
} 

</SCRIPT> 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 


X 


X 
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.13 Subpicture Event 

Summary 

Called when there is a change in sub-pictures. Returns 
the new sub-picture number in subpictureNum. 
Return parameters 

subpicture Sub-picture number, signed 1 byte 
Num integer ranging from 0-31 

If the value returned is 99, then this 
means sub-pictures were turned off. 

Example 

Trigger an event when sub-picture stream changes : 
<SCRIPT LANGUAGE= n JavaScript" > 
function SubpictureEvent (subpictureNum) 
if (subpictureNum == 2) 

{ 

// Trigger event based on sub -picture change 
to stream 2 

} 

</SCRIPT> 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 





.14 Parental Event 

Summary 

Called when parental control changes. 

Return parameters 

parentalNu Parental level number, signed 1 byte 
m integer ranging from 1-8 

Example 

Set the ParentalEvent and test when it triggers: 
<SCRIPT LANGUAGE^ " JavaScript " > 
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function ParentalEvent (parentalNum) 
if (parentalNum > 3) 

{ 

// do stuff here.., 

} 

</SCRIPT> 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 





• 15 Region Event 

Summary 

Called when there is a mismatch in the region of the 
device and disc. 
Return parameters 

regionNum Region code of the disc; signed 1 byte 
integer 0x00 = unknown disc region 



0x01 




Region 1 


0x02 




Region 2 


0x04 




Region 3 


0x08 




Region 4 


0x10 




Region 5 


0x20 




Region 6 


0x40 




Reserved 


0x80 




Reserved for sign 



Example 

Trigger an event when a region mismatch occurs: 
<SCRIPT LANGUAGE= " JavaScript " > 
function RegionEvent (regionNum) 
if (regionNum == 01) 

{ 
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// Trigger event when disc is NA; SPRM20 has 
system region 

> 

</SCRIPT> 

5 Media Supported 



DVD 

Video 


DVD 
Audio 


CD 

Audio 


X 


X 


X 



A, 3. 16 Eject Event 

Summary 

Called when the disc is ejected from the device. 
Return parameters 

None 
Example 

Trigger an event when the disc is ejected: 
<SCRIPT LANGUAGE=" JavaScript "> 
function EjectEventO 

// Trigger event based on disc ejection 

</SCRIPT> 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 


X 


X 


X 



A* 3 .17 Insert Event 

2 0 Summary 

Called when a disc is inserted. 
Return parameters 

None 
Example 

Trigger an event when the disc is inserted: 
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<SCRIPT LANGUAGE= n JavaScript" > 
function InsertEvent () 

// Trigger event based on disc insertion 

</SCRIPT> 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 


X 



18 GPRM Event 

Summary 

Called when a GPRM changes. Returns register number 
and register contents. 
Return parameters 

regNum GPRM Register Number signed 1 byte 

value ranging from 0 to 15 
regVal New value of GPRM; Unsigned 2 byte 

(16-bit) value 

Example 

Trigger an event when GPRM (15) changes: 
<SCRIPT LANGUAGE* "JavaScript" > 
function GPRMEvent (regnum, regVal) 
if ( (regNum == 15) && (regVal 10) ) 
{ 

// Trigger event based on GPRM (15) = 10 

} 

</SCRIPT> 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 


X 


X 





19 Info Event 
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Summary 

Called when the user requests information. This event 
will be triggered by a button on a computer window or 
a button on the remote control (for a set top player) 
being pressed. The content (namely, the JavaScript 
private function for the title) will determine the 
course of action. 

Return parameters 
none 

Example 

Trigger an information request event because the RC 

button was pressed. In this case, if the title is 23, 

we will load a web page. 

<SCRIPT LANGUAGE- "JavaScript" > 

function Inf oLinkEvent ( ) 

If InterActual.TitleNum m 23 

{ 

//...load page associated with title 23 

} 

</SCRIPT> 

Notes 

This event type, by default, is not subscribed to. It 
must be explicitly subscribed to using 
SubscribeToEvent . 
Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 


X 


X 





.20 RC Button Event 

Summary 

Called when a button on the remote control (RC) has 
been pressed. Returns the button number from the list 
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below. 
Return parameters 

rcButton Button number, signed 1 byte integer 
ranging from 1-99 
1: Stop 
2 : Pause 
3: Play 

4: Previous Chapter/Track 

5: Next Chapter /Track 

6: Fast Forward 

7: Fast Reverse 

8: Scan/Slow forward 

9: Scan/Slow reverse 

10: DVD Menu 

11: Title 

12: Audio 

13: Angle 

14: Subtitle or Subpicture 

15: Up arrow 

16: Down arrow 

17: Left arrow 

18: Right arrow 

19: Select 

20: PlayHandler (for computer control; 
not sent during playback) 
21: Fullscreen 

Example 

Trigger an event based on button event. 
<SCRIPT LANGUAGE^ "JavaScript" > 
function RCButtonEvent (rcButton) 
if (rcButton == 5) { 

// Trigger event based on Next button pressed 

} 
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</SCRIPT> 

Notes 

This event type, by default, is not subscribed to. It 
must be explicitly subscribed to using 
SubscribeToEven t . 
Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 


X 


X 





21 Number of Angles Event 

Summary 

Called when the total number of angles has changed. 
Returns the new total number of angles in totalNum. 
Return parameters 

totalNum Total number of angles available, 

signed 1 byte integer ranging from 1 - 
9 

Example 

Trigger an event when the total number of angles is 
greater than 1: 

<SCRIPT LANGUAGES 11 JavaScript 11 > 
function NumAnglesEvent (totalNum) 
if (totalNum > 1) 

{ 

// Trigger when multiple angles are available 

> 

</SCRIPT> 

Media Supported 



DVD 


DVD 


CD 


Video 


Audio 


Audio 
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A. 3. 22 Net Event 

Summary 

Called on state change of the network connectivity. 
Return parameters 

NetStateNu State number, signed 1 byte integer 
m ranging from 0-4 

4: Initializing the network interface 
or MODEM 

3: Waiting for dial-tone or signal 

2: Dialing or connecting 

1 : Logging in to service 0 : Connected 

Example 

After subscribing to this event and calling the 
NetConnecti) interface, this event will trigger as the 
connection is being established: 
<SCRIPT LANGUAGE^ "JavaScript" > 
function NetEvent (NetStateNum) 
If (NetStateNum == 0) 
{ 

// Load page... 

} 

</SCRIPT> 

Notes 

This event type, by default, is not subscribed to. It 
must be explicitly subscribed to using 
SvbscribeToEvent . 
Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 


X 


X 


X 
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A. 4 Interface applicability 

The following matrix depicts the applicability of each component 
of the interface (commands, properties and events) depending 
upon the state of the system. An %X X" indicates that the entity 
is executable in this state if the user operations (UOP bits) 
allow it; these bits are set by the disc content itself. 

Stop state means no specific title is selected and on computers, 
the DVD navigator is not instantiated. 

File open means the state reached when calling the advanced API 
"Open" command with a filename as the argument. In other words, 
the DVD navigator is instantiated and a file, not a DVD title, 
has been selected. Hence, the DVD navigation features are not 
available . 

If the JavaScript calls InterActual. Open ("DVDVideo") you will 
automatically transition to the Play state because First PGC 
will be played. 
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BASIC INTERACTUAL API 












COMMANDS 












Inter Actual .Play 






X 




X 


InterActual . PlayTitle 






X 


X 


X 


InterActual . PlayChapter 






X 


X 


X 


InterActual . PlayChapterAut 
oStop 












InterActual . PlayTime 






X 


X 


X 


InterActual . PlayTimeAutoSt 
op 












InterActual . PlayTitleGroup 






X 


X 


X 


InterActual . PlayTrack 






X 


X 


X 
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InterActual . SearchChapter 








X 


X 


InterActual . SearchTime 








X 


X 


InterActual . SearchTrack 






X 


X 


X 


InterActual .TotalNumChapte 
rs 






X 






InterActual .NextPG 








X 


X 


InterActual . PrevPG 








X 


X 


InterActual . GoUp 










X 


InterActual .NextTrack 








X 




InterActual . PrevTrack 








X 




InterActual .TotalTrackTime 






X 






InterActual .NextSlide 








X 




InterActual . PrevSlide 








X 




InterActual . Pause 








X 




InterActual . Stop 








X 


X 


InterActual . FastForward 








X 




InterActual . Rewind 








X 




InterActual . Menu 






X 


X 


X 


InterActual . Resume 






X? 




X 


InterActual . StillOf f 








X 


X 


InterActual .SelectUpButton 








X 


X 


InterActual . SelectDownButt 
on 








X 


X 


InterActual .SelectLef tButt 
on 








X 


X 


InterActual . SelectRightBut 
ton 








X 


X 


InterActual » SelectButtonAn 
dActivate 








X 


X 


InterActual .ActivateButton 








X 


X 
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InterActual . SelectAudio 








X 


X? 


InterActual . SelectSubpictu 
re 








X 


X? 


InterActual . SelectAngle 








X 


X? 


InterActual . SelectParental 
Level 


X 




X 






InterActual . AudioLanguage 






X 


X 


X 


InterActual . AudioLanguageE 
xt ens ion 






X 


X 


X 


InterActual . SubpictureLang 
uage 






X 


X 




X 


InterActual . SubpictureLang 
uageExtension 






X 


X 


X 


InterActual . GetGPRM 






X 


X 


X 


InterActual .Get SPRM 






X 


X 


X 


InterActual . ValidUOP 






X 


X 


X 


InterActual .GetBCAField 






X 


X 


X 


InterActual . SupportedFeatu 
res 


X 


X 


X 


X 


x 


InterActual . EnableSubpictu 
re 








X 


X 


InterActual . SetGPRM 








X 


X 


InterActual .Mute 


X 


X 


X 


X 


X 


InterActual . Fullscreen 








X 


X 


InterActual . GotoBookmark 






X 


X 


X 


InterActual . SaveBookmark 






? 


X 


X 


InterActual .NetConnect 


X 


X 


X 


X 


X 


InterActual . NetDisconnect 


X 


X 


X 


X 


X 


InterActual . SubscribeToEve 
nt 


x 1 


X 


X 


X 


X 
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PROPERTIES 












InterActual . ElapsedTime 








X 


X 


InterActual .TotalElapsedTi 
me 








X 




InterActual . TotalTime 








X 


X 


InterActual .Tit leNumber 








X 




InterActual . PGCNumber 








X 




InterActual . ChapterNumber 








X 




InterActual . TitleGroupNumb 
er 








X 




InterActual . TrackNumber 








X 





InterActual . SlideNumber 








X 




InterActual . PlayState 






X 


X 


X 


InterActual .Domain 






X 


X 


X 


InterActual . AudioNumber 








X 




InterActual . SubpictureNumb 
er 








X 




InterActual .AngleNumber 








X 




InterActual . ParentalLevel 








X 




InterActual . ButtonNumber 








X 


X 


InterActual .TotalNumAudio 








X 




InterActual .TotalTracks 








X 




InterActual .TotalTitles 








X 


X 


InterActual . TotalNumSubpic 
ture 








X 




InterActual .TotalNumAngle 








X 




InterActual . TotalNumButton 








X 


X 


InterActual .Ma jorVers ion 


X 


X 


X 


X 


X 


InterActual .MinorVers ion 


X J 


X 


X 


X 


X 
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InterActual . PlayerMode 


X 


X 


X 


X 


X 


InterActual .MaxFast 








X 


X 


InterActual .MaxFastReverse 








X 


X 


InterActual . MedialD 






X 


X 


X 


InterActual .DiscType 


X 




X 


X 


X 


InterActual . Bookmark 






X 


X 


X 


InterActual . ROMType 






X 


X 


X 


InterActual . InternetStatus 


X 




X 


X 


X 


InterActual . FullScreenMode 








X 


X 


EVENTS 












Title Event 








X 




Chapter Event 








X 




PGC Event 








X 




Time Event 








X 




Track Time Event 








X 




Title Group Event 








X 




Track Event 








X 





Slide Event 








X 




Angle Event 








X 




State Event 






X 


X 


X 


Speed Event 






- 


X 




UOP Event 






X 


X 


X 


Domain Event 






X 


X 


X 


Audio Event 








X 


— — 


Subpicture Event 








X 




Parental Event 








X 




Region Event 








X 




Eject Event 






X 


X 


X 



162 of 225 







■1 




1 




Insert Event 


x 










GPRM Event 








X 


X 


Info Event 


X 




X 


X 


X 


RC Button Event 


X 


X 


X 


X 


X 


Number of Angles Event 








X 





Note: For the RC Button Event , the subtype of 
PlayHandler (20) will not be sent during playback 
(Play state or title domain) so that it can be used 
for resume functional ity. 
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The DVD-Audio Specific Interface 



Commands 

L InterActual . PlayTitleGroup (g) 

Summary 

Start playback of the specified title group number. 
Parameters 

g Title group number ranging from 1-9 

(within current Volume) ; signed 1 byte 
integer 

Example 

Start playing the 3 rd title group. 
InterActual . PlayTitleGroup (3 ) 

Notes 

This method shall not be used for playing a Hidden 

Group. The method InterActual .HiddenPlayGroup ( ) shall 

be used instead. 
See also 

InterActual . PlayTrack (g, t) 
Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 




X 





Return Values 



Numbe 
r 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralErro 
r 


Unknown error condition 


-3 


Not Support e 
d 


File type or feature not 
supported at this time 


-2 


UOPNot Allow 


Operation not allowed by current 
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ed 


UOP fields 


-5 


NoDisc 


Attempt to play with no disc 


-6 


ParmRangeEr 
r 


Parameter out of range or 
invalid 



B . 1 . 2 InterActual . NextSlide { ) 

Summary- 
Presents the next visual display/slide in the display 
list to the user. 

Parameters 

None required 

Example 

Step to the next slide on a DVD-Audio disc. 
InterActual. NextSlide () 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 




X 





Return Values 



Number 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAllowe 
d 


Operation not allowed by current 
UOP fields 


-3 


NotSupported 


File type or feature not 
supported at this time 


-5 


NoDisc 


Attempt to play with no disc 



B • 1 . 3 InterActual ♦ PrevSlide ( ) 

Summary 

Presents the previous visual display/slide in the 
display list to the user. 
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Parameters 
None 
required 

Example 

Display previous slide in a slide presentation on a 
DVD-Audio disc. 
InterActual.PrevSlide () 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 




X 





Return Values 



Numbe 
r 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralErro 
r 


Unknown error condition 


-2 


UOPNot Allow 
ed 


Operation not allowed by current 
UOP fields 


-3 


Not Support e 
d 


File type or feature not 
supported at this time 


-5 


NoDisc 


Attempt to play with no disc 



B.2 Properties 

B . 2 . 1 InterActual . Ti tleGroupNumber 

Summary 

Returns the currently playing title group number. 
Return Value 

JavaScript Signed 1 byte integer ranging from 

Number 1-9 

Example 

Query the current title group number. 

TitleGrpNum = InterActual .TitleGroupNumber 
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Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 




X 
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B ♦ 2 . 2 InterActual . SlideNumber 

Summary 

Returns the currently playing slide/display number. 
Return Value 

JavaScript Signed 1 byte integer ranging from 

Number 1-99 

Example 

Query the current slide/display number. 
CurrSlideNumber = InterActual . SlideNumber 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 




X 
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B.3 Events 



B.3.1 Title Group Event 

Summary 

Called when the title group changes. Returns -the new 
title group number in groupNum. 
Return parameters 

groupNum Signed 1 byte integer ranging from 1 - 
9 



|y 
in 

in 

m 
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■a -iswr 

IB 

i* 



10 



15 



Example 

Trigger an event when playback reaches Title Group 5: 
<SCRIPT LANGUAGE* "JavaScript" > 
function TitleGroupEvent (groupNum) 
If (groupNum == 5) 

{ 

// Trigger event once in Title Group 5 

} 

</SCRIPT> 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 




X 





B.3. 2 Slide Event 

2 0 Summary 

Called when the slide/display list changes. Returns the 
new slide number in slideNum. 
Return parameters 

slideNum Slide number, signed 1 byte integer 
ranging from 1-99 

Example 

25 Trigger an event when slide number 13 is reached: 
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<SCRIPT LANGUAGE^ "JavaScript" > 
function SlideEvent (slideNum) 
if (slideNum == 13) 

{ 

// Trigger event once on Slide 13 

} 

</SCRIPT> 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 




X 
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B.4 Advanced Commands 



111 



10 



15 



B . 4 . 1 InterActual . HiddenPlayGroup (x) 

Summary 

Play hidden group if the 4 digit key number is entered 
properly. 
Parameters 

x Four digit key number; signed 2 

byte integer ranging from 0000-9999 

Example 

Play the hidden group, using the key number 1234. 
Int erAc tual . HiddenPlayGroup (1234) 

See also 

InterActual . HiddenPlayTrack ( t , x) 

InterActual . HiddenPlayTime (h, m, s , x) 
Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 




X 





Return Values 



Numbe 
r 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralErro 
r 


Unknown error condition 


-2 


UOPNot Allow 
ed 


Operation not allowed by current 
UOP fields 


-3 


Not Support e 
d 


File type or feature not 
supported at this time 


-5 


NoDisc 


Attempt to play with no disc 


-6 


ParmRangeEr 
r 


Parameter out of range or 
invalid 
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2 InterActual . HiddenPlayTrack ( t , x) 

Summary 

Play the desired hidden or locked track within the 
hidden group specified 
Parameters 

t Track number ranging from 1-99; 

signed 1 byte integer 
x Four digit key number; signed 2 

byte integer ranging from 0000-9999 

Example 

Play the 5 th track of the hidden group, using the key 
number 1234. 

InterActual • HiddenPlayTrack (5 , 1234) 

See also 

InterActual . HiddenPlayGroup (x) 

InterActual .HiddenPlayTime (h,m, s,x) 
Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 




X 





Return Values 



Numbe 
r 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralErro 
r 


Unknown error condition 


-2 


UOPNot Allow 
ed 


Operation not allowed by current 
UOP fields 


-3 


Not Support e 
d 


File type or feature not 
supported at this time 


-5 


NoDisc 


Attempt to play with no disc 


-6 


ParmRangeEr 
r 


Parameter out of range or 
invalid 
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3 InterActual . Hidden? layTime (lx,m, s , x) 

Summary 

This command plays from specific time within the Hidden 
Group . 
Parameters 

h Hours, integer ranging from 00 - 23/ 

signed 1 byte integer 
m Minutes, integer ranging from 00 - 

59; signed 1 byte integer 
s Seconds, integer ranging from 00 - 

59; signed 1 byte integer 
x Four digit key number; signed 2 

byte integer ranging from 0000-9999 

Example 

Play starting at 2 minutes in within the Hidden Group, 
using the key number 1234. 
InterAc tual • HiddenPlayTime (0,2,0,1234) 
Media Supported 



DVD Video 


DVD 
Audio 


CD Audio 




X 





Return Values 



Numbe 
r 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralErro 
r 


Unknown error condition 


-2 


UOPNot Allow 
ed 


Operation not allowed by current 
UOP fields 


-3 


NotSupporte 
d 


File type or feature not 
supported at this time 


-5 


NoDisc 


Attempt to play with no disc 
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ParmRangeEr 


Parameter out of range or 


-6 


r 


invalid 



B . 4 . 4 Inter Actual . SelectTextLanguage (n) 

Summary 

Selects the language for the Audio Text Data. 
5 Parameters 

n Audio text language code; shall adhere 

ISO-639. See the language codes 
section in the appendix; 
Unsigned 2 byte char 

Example 

Set the audio text language to English, which is "en" . 
InterActual • SelectTextLanguage ( w en") 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 




X 





ig 10 Return Values 



Number 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAllowe 
d 


Operation not allowed by current 
UOP fields 


-3 


Not Supported 


File type or feature not 
supported at this time 


-6 


ParmRangeErr 


Parameter out of range or invalid 
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C Advanced InterActual API 



The interface described in this appendix are not required, 
however they can be implemented and an InterActual disc can 
5 interrogate the system using the SupportFeatures command to 
determine if the current device supports them. 



C * 1 Commands 



•■s fa? 



If! 



3 : 



10 C.l.l InterActual. Open (filename | type) 

Summary 

Opens specified file name. 

Parameters 

filename Char string with file name (maximum of 
256 chars) 

type Char string as follows (max of 8 chars) 



IP w DVDVideo" 



"DVDAudio" 
^CDAudio" 

Ifj Example 

\Z 15 Open the DVD Video File for Playback. 

N< InterActual • Open ( "d : \\video_ts\\video_ts . if o" ) 

InterActual • Open ( xx DVDVideo" ) 

Notes 

Opening of VOB files and MPEG files are optional, but 
20 suggested. Other file types are advanced features. An 

open file can be played, paused, stopped; fast-forward 
and rewind are not available. Stopping causes the file 
pointer to be reset to the start of the file. 
Requires 

25 Currently, this command is only available on a 

computer platform. 
Media Supported 
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DVD Video 


DVD 
Audio 


CD Audio 


X 


X 


X 



Return Values 





Name 


jjc s c i ipu i on 


A 
\J 






-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAllowe 
d 


Operation not allowed by current 
UOP fields 


-3 


Not Supported 


File type or feature not 
supported at this time 


-4 


FileNotFound 


File not found 


-5 


NoDisc 


Attempt to play with no disc 


-6 


ParmRangeErr 


Parameter out of range or invalid 



• 2 InterActual . Slow (x) 

Summary 

Play the current DVD at speed x where the x=2 is for 
speed. 
Parameters 

x x can range from 2-99; signed 1 

byte integer 

Example 

Play the current DVD at % the normal speed. 
InterActual . Slow (4 ) 

Notes 

Some players may only allow values of 2, 4, 8, 16, and 
32. If Slow is supported a speed of % is required. 
Other speeds may also be supported; decreasing powers 
of two are recommended although any value from 2 to 99 
is allowed (integer reciprocal values are used for the 
speeds, such as 2 for % and 4 for hi, etc) . 
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If this command is used with a value not in the list, 
then the underlying software will approximate to the 
nearest available value (for instance 3 is specified 
and 4 is chosen) rather than return with an error code. 
Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 


X 


X 





Return Values 



Number 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAllowe 
d 


Operation not allowed by current 
UOP fields 


-3 


NotSupported 


File type or feature not 
supported at this time 


-5 


NoDisc 


Attempt to play with no disc 


-6 


ParmRangeErr 


Parameter out of range or invalid 



♦ 3 InterActual . Step (n) 

Summary 

This command steps playback of the DVD forward n 
frames . 
Parameters 

n n can range from 1 - 30; signed 1 byte 

integer 

Example 

Step playback of the DVD forward 1 frame at a time. 
InterActual * Step (1) 

Notes 

Supported Features should be checked first to determine 
if capability is supported. 
Media Supported 
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DVD 
Video 


DVD 
Audio 


CD 

Audio 


X 







Return Values 



liUUUJgl 




uescr ipuion 


0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAllowe 
d 


Operation not allowed by current 
UOP fields 


-3 


Not Supported 


File type or feature not 
supported at this time 


-5 


NoDisc 


Attempt to play with no disc 


-6 


ParmRangeErr 


Parameter out of range or invalid 



. 4 InterActual • SlowReverse (x) 

Summary 

Play the current DVD at x speed in reverse (x = 2 for % 
speed) ♦ 
Parameters 

x x can range from 2-99; signed 1 byte 

integer 

Example 

Play the current DVD in reverse at % the normal 
playback speed. 
InterActual •SlowReverse (2 ) 

Notes 

Supported Features should be checked first to determine 
if capability is supported. See note on Slow for 
recommendations . 

Some players will only allow values such as 2, 4, 8, 
16, etc. If this command is used with a value not in 
the list, then the underlying software will approximate 
to the nearest available value (for instance 3 is 
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specified and 4 is chosen) rather than return with an 
error code. 
Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 


X 


X 





Return Values 



Number 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAllowe 
d 


Operation not allowed by current 
UOP fields 


-3 


NotSupported 


File type or feature not 
supported at this time 


-5 


NoDisc 


Attempt to play with no disc 


-6 


ParmRangeErr 


Parameter out of range or invalid 



♦ 5 InterAc tual . Zoom (x, y) 

Summary 

This command will zoom, or scale, by a percentage 
factor of x (horizontal) and y (vertical) . 
Parameters 

x Unsigned 4 byte (32 -bit), 100 times the 

percentage. 

Defaults to a value of 10000 meaning 
100%. 

y Unsigned 4 byte (32-bit), 100 times the 

percentage . 

Defaults to a value of 10000 meaning 
100%. 

Example 

Zoom to 200% maintaining the same aspect ratio. 
Inter Ac tual, Zoom (2 0000, 20000) 
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Notes 

Zoom parameters are based on a percentage, so integer 
values of 10000 and 10000 (x and y) indicate 100% of 
normal full screen display with no zoom. Normally the x 
and y scale factors should be the same to maintain a 
correct aspect ratio. When zooming to a value greater 
than 100%, by default, the center point of the image 
remains on the center of the display. Individual 
players may support various zoom ranges, but 25% to 
400% is recommended (2500 < x,y < 40000) . 
Panning allows moving the center point of the portion 
of the image to be displayed. These x and y pan 
parameters are provided as a percentage of the display 
from -50% to +50% using integer values from -5000 to 
+5000. (This is done so that the differences between 
NTSC and PAL do not have to be calculated in pixels. 
Additionally, it may also be possible to use the same 
HTML code for handling 4:3 and 16:9 as well.) If the 
pan parameters would cause the display to pan off the 
edge of the video, then the platform software shall 
only set that panning parameter to the largest or 
smallest value that keeps the video in the display 
area. 
Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 


X 


X 





Return Values 



Number 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 




UOPNotAllowe 


Operation not allowed by current 


-2 


d 


UOP fields 
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-3 


Not Supported 


File type or feature not 
supported at this time 


-6 


ParraRangeErr 


Parameter out of range or invalid 


-7 


MemoryErr 


Not enough memory for operation 



. 6 InterActual . Pan (x,y) 

Summary 

This command will set the center point of the zoomed 
display to x,y coordinates based on the percentage of 
normal content full screen display. 
Parameters 

x Unsigned 4 byte (32-bit), 100 times the 

percentage • 

Defaults to a value of 0 

y Unsigned 4 byte (32-bit), 100 times the 

percentage. 

Defaults to a value of 0. 

Example 

Set the center point to -10%, 10%. 

InterActual. Pan (-1000, 1000) 

Notes 

Panning allows moving the center point of the portion 
of the image to be displayed. These x and y pan 
parameters are provided as a percentage of the display 
from -50% to +50% using integer values from -5000 to 
+5000. (This is done so that the differences between 
NTSC and PAL do not have to be calculated in pixels. 
Additionally, it may also be possible to use the same 
HTML code for handling 4:3 and 16:9 as well.) If the 
pan parameters would cause the display to pan off the 
edge of the video, then the platform software shall 
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only set that panning parameter to the largest or 
smallest value that keeps the video in the display- 
area . 
Media Supported 



DVD Video 


DVD 
Audio 


CD Audio 


X 


X 





Return Values 



Number 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAllowe 
d 


Operation not allowed by current 
UOP fields 


-3 


Not Supported 


File type or feature not 
supported at this time 


-6 


ParmRangeErr 


Parameter out of range or invalid 


-7 


MemoryErr 


Not enough memory for operation 



♦ 7 InterActual . EnableCCText (n) 

Summary 

Enables or disables closed captioning. 
Parameters 

n If n is 0, then disable closed 

captioning (off) 
If n is 1, then enable closed 
captioning (on) 
Signed 1 byte integer 

Example 

Enable closed captioning: 
InterActual .EnableCCText (1) 
Media Supported 



DVD Video 


DVD 


CD Audio 




Audio 
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X 



Return Values 





Name 




o 


OK 




-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAllowe 
d 


Operation not allowed by current 
UOP fields 


-3 


Not Supported 


File type or feature not 
supported at this time 


-6 


ParmRangeErr 


Parameter out of range or invalid 



8 InterAc tual • MenuLanguage (n , r c ) 

Summary 

Returns the menu language character code for the 
specified menu language. 
Parameters 

n Menu language number ranging from 1- 

30 will be likely, however 1-65535 
is the allowable range; signed 2 
byte integer 

rc Character return value; unsigned 2 

bytes char represented by the coded 
^Language Symbols" defined in ISO- 
639. See the language codes section 
in the appendix. 

Return Value 



Number 


Name 


Description 


0 


OK 


Successful execution but code not 
specified 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAllowe 
d 


Operation not allowed by current 
UOP fields 


-3 


Not Supported 


File type or feature not 
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supported at this time 


-6 


ParmRangeErr 


Parameter out of range or invalid 



Example 

Query the language information for menu language 1. 
MenuLanguage = InterActual •MenuLanguage (1) 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 


X 


X 





C . 1 • 9 InterActual . SelectMenuLanguage (n) 

Summary 

Selects the language for the Video or Audio Manager 
Menu according to the language code (n) . 
Parameters 

n Menu language code; shall adhere to 

ISO-639. See the language codes 
section In the appendix; 
Unsigned 2 byte char 

Example 

Set the menu language to English, which is "en". 
InterActual . SelectMenuLanguage ( w en") 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 


X 


X 





Return Values 



Numbe 
r 


Name 


Description 


0 


OK 


Successful 




GeneralErro 


Unknown error condition 


-1 


r 





183 of 225 





UOPNotAllow 


Operation not allowed by current 

TTflD -F -1 cil r\ o 
Uur IlciaS 


-3 


Not Support e 
d 


File type or feature not supported 
at this time 


-6 


ParmRangeEr 
r 


Parameter out of range or invalid 



C . 1 . 10 InterActual . SelectParentalCountry (n) 

Summary 

Selects the country for the parental level . 
Parameters 

n Country code to be set according to the 

Alpha -2 code defined in IS03166. 
2 byte character 

Example 

Set the Parental Country Code to United States . 
InterActual .SelectParentalCountry ("US") 

Notes 

This command is only available in Stop State. 
Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 


X 







Return Values 



Numbe 
r 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNot Allowed 


Operation not allowed by current 
UOP fields 


-6 


ParmRangeErr 


Parameter out of range or invalid 



C . 1 . 11 InterActual * Selec tKaraoke (x) 
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Summary 

This command changes the audio mode for Karaoke. 
Parameters 

x Signed 1 byte integer; audio mode 

where x is 
1: guide vocal 1 
2 : guide vocal 2 
3 : guide melody 1 
4: guide melody 2 (if present) 
5: sound effect (if present) 

Example 

Listen to the guide melody of the current Karaoke disc. 
InterAc tual . SelectKaraoke (3 ) 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 


X 







Return Values 



Numbe 
r 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAllowed 


Operation not allowed by current 
UOP fields 


-3 


Not Supported 


File type or feature not 
supported at this time 


-6 


ParmRangeErr 


Parameter out of range or invalid 



12 InterActual . SetMixVolume (x) 

Summary 

This command sets the primary audio stream volume level 
to percentage x to allow over-mixing. 
Parameters 
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X Percentage for audio stream volume. 

Signed 1 byte integer ranging from 0 - 
100 

Setting x to 0 will mute the main audio. 

Example 

Set volume to 50%. 
InterActual . SetMixVolume (50) 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 


X 


X 


X 



Return Values 



Number 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAllowe 
d 


Operation not allowed by current 
UOP fields 


-3 


NotSupported 


File type or feature not 
supported at this time 


-6 


ParmRangeErr 


Parameter out of range or invalid 



CI. 13 InterActual. Close () 

Summary 

Close the driver and stop playback of the current DVD 
while playing on a computer. 
Parameters 
None 
required 
Example 

Close the driver and stop playback. 
InterActual ♦ Close ( ) 

Notes 
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This is a computer only command. A consumer 
electronics device should treat this command as 
Inter Actual .Stop {) . 
Media Supported 



DVD Video 


DVD 
Audio 


CD Audio 


X 


X 


X 



Return Values 



Number 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAllowe 
d 


Operation not allowed by current 
UOP fields 


-3 


NotSupported 


File type or feature not 
supported at this time 



14 InterActual . ShowControls ( ) 

Summary 

Show the video controls while playing an InterActual 

disc on a computer. 
Parameters 

None required 
Example 

Show the controls. 

InterActual ♦ ShowControls () 
Notes 

This is a computer only command. A consumer 
electronics device should ignore this command. The 
coordinate system for both PC and Macintosh will be 
defined with top left as 0,0 with x moving from top 
left to top right and y moving from top left to bottom 
left. 
Media Supported 
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DVD Video 


DVD 
Audio 


CD Audio 


X 


X 





Return Values 



Number 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAllowe 
d 


Operation not allowed by current 
UOP fields 


-3 


NotSupported 


File type or feature not 
supported at this time 



. 15 Inter Actual . HideControls ( ) 

Summary 

Hide the video controls while playing an InterActual 

disc on a computer. 
Parameters 

None required 
Example 

Hide the controls. 

InterActual .HideControls () 

Notes 

This is a computer only command. A consumer 
electronics device should ignore this command. The 
coordinate system for both PC and Macintosh will be 
defined with top left as 0,0 with x moving from top 
left to top right and y moving from top left to bottom 
left. 
Media Supported 



DVD Video 


DVD 
Audio 


CD Audio 


X 


X 





Return Values 
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Number 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAllowe 
d 


Operation not allowed by current 
UOP fields 


-3 


Not Supported 


File type or feature not 
supported at this time 



. 16 InterActual . ShowContextMenu (mask) 

Summary 

Controls the right mouse click context menu that 
displays on a computer. 
Parameters 

mask Unsigned 1 byte integer 

0x00 Suppress display of context 
menu 

0x01 Play, Pause, Stop 
0x02 Fast forward and rewind 
0x04 Next chapter, previous 
chapter 

0x08 DVD Menu 

0x10 Sub-picture, audio and angle 
menus 

0x20 Full screen menu 
0x80 Exit menu 

Example 

Show all options in the context menu on a right mouse 
click 

InterActual . ShowContextMenu (OxBF) 

Notes 

This is a computer only command. A consumer 
electronics device should ignore this command. 
Media Supported 
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DVD Video 


DVD 
Audio 


CD Audio 


X 


X 





Return Values 



Number 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAllowe 
d 


Operation not allowed by current 
UOP fields 


-3 


Not Supported 


File type or feature not 
supported at this time 


-6 


ParmRangeErr 


Parameter out of range or invalid 



. 17 InterActual . PopUpMenu (n, x, y) 

Summary 

Displays and allows the audio languages, sub-pictures, 
and angles to be set to those currently available. 
Parameters 

n Signed 1 byte integer 

4 = Audio Language 

5 = Sub-picture 

6 = Angle 

x x coordinate on computer screen 

y Y coordinate on computer screen 

Example 

Show the pop up menu. 
InterActual • PopUpMenu ( ) 

Notes 

This is a computer only command. A consumer 
electronics device should ignore this command. The 
coordinate system for both PC and Macintosh will be 
defined with top left as 0,0 with x moving from top 



190 of 225 



left to top right and y moving from top left to bottom 
left. 
Media Supported 



DVD Video 


DVD 
Audio 


CD Audio 


X 


X 





Return Values 



Number 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAllowe 
d 


Operation not allowed by current 
UOP fields 


-3 


Not Supported 


File type or feature not 
supported at this time 


-6 


ParmRangeErr 


Parameter out of range or invalid 



CM. 18 InterActual.SuppressErrors (b) 

Summary 

Suppresses display of error messages. 
Parameters 

b Signed 1 byte integer 

If b = 0, suppress the display of 
messages If b = 1, display error 
messages 

Example 

Suppress all error messages. 
InterActual.SuppressErrors (0) 

Notes 

This is a computer only command. A consumer 
electronics device should ignore this command. 
Media Supported 



DVD Video 


DVD 


CD Audio 




Audio 
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X 



X 



Return Values 



Number 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAllowe 
d 


Operation not allowed by current 
UOP fields 


-3 


NotSupported 


File type or feature not 
supported at this time 


-6 


ParmRangeErr 


Parameter out of range or invalid 



C . 1 ♦ 19 InterActual . AutoMouseHide (b) 

Summary 

Show or hide the mouse cursor when the DVD is playing 
(this is a toggle control) . This method is for 
computers only. 
Parameters 

b Signed 1 byte integer 

When b = 0, do not hide mouse 

When b = 1, automatically hide mouse 

after 2 seconds 

Example 

Automatically hide the mouse after 2 seconds. 
InterActual ♦AutoMouseHide (1) 

Notes 

By default, hiding of the mouse cursor occurs 2 
seconds after no activity. This method is for 
computers only. 
Media Supported 



DVD Video 


DVD 
Audio 


CD Audio 


X 


X 


X 



Return Values 
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Number 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAllowe 
d 


Operation not allowed by current 
UOP fields 


-3 


NotSupported 


File type or feature not 
supported at this time 


-6 


ParmRangeErr 


Parameter out of range or invalid 



C.1.20 InterActual,OpenDrive() 

Summary 

This command provides control of the media drive to 
open the drive, which will eject the media, or close 
the drive based on the current state of the drive. 

Parameters 

None required 

Example 

Eject the media from the drive. 
Inter Ac tual . OpenDrive ( ) 

Notes 

If the device is playing the playback must first be 
stopped before the media can be ejected. 
Media Supported 



DVD Video 


DVD 
Audio 


CD Audio 


X 


X 


X 



Return Values 



Numbe 
r 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNot Allowed 


Operation not allowed by current 
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UOP fields 


-3 


NotSupported 


File type or feature not 
supported at this time 



C.1.21 Inter Actual. Launch (a, p) 

Summary 

This command provides the ability to launch an 
application co-located on the disc. 
Parameters 

a Application name and fully qualified 

path derived from the DiscDirectozy 
property; Char string 

p Parameter list for application; Char 

string 

If this string contains a disc 
filename, the path must be fully 
qualified. 

Example 

Launch the setup application for an extra from the 
disc. 

ddir = InterActual.DiscDirectory; 

InterActual. Launch (ddir + "/EXTRAS/" + "setup ,exe", 
u ") ; 

Notes 

Macintosh does not support parameter lists. 
Note: The ability to launch another application 
from the JavaScript is both a valuable feature and 
a potential exposure to system security. As such, 
this command must be limited to launch only files 
from the disc directory (as derived from the 
DiscDirectory property) 
Media Supported 



DVD Video DVD 



CD Audio 
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Audio 




X 


X 


X 



Return Values 



Number Name 

i 


Description 


0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAllowe 
d 


Operation not allowed by current 
UOP fields 


-3 


Not Supported 


File type or feature not 
supported at this time 


-4 


FileNotFound 


File not found 


-7 


MemoryErr 


Not enough memory for operation 



. 22 InterActual . PresentationMode (a,m) 

Summary 

This command sets the aspect ratio to either wide 
screen (16:9) versus full frame (4:3), and the 
preference for the video display mode when displaying 
16:9 material on a 4:3 display. 
Parameters 

a Aspect ratio of output device; can 

range from 0-2 where 
0 : 4:3 device 
1: reserved 
2: 16:9 

signed 1 byte integer 
m Mode of 16:9; can range from 0-2 

where 
0 : wide 
1: pan scan 
2 : letterbox 
signed 1 byte integer 

Example 
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Set the mode to wide screen letterbox 
InterAc tual . Presentat ionMode (2,2) 

Notes 

If the mode is not available on the disc, for instance 
no wide screen 16:9 content, then this command will 
return a "-3", not supported. 
Media Supported 



DVD Video 


DVD 
Audio 


CD Audio 


X 


X 





Return Values 



Numbe 
r 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAl lowed 


Operation not allowed by current 
UOP fields 


-3 


Not Supported 


File type or feature not 
supported at this time 


-5 


NoDisc 


Attempt to play with no disc 


-6 


ParmRangeErr 


Parameter out of range or invalid 



.23 InterAc tual. Print (f) 

Summary 

This command provides the ability to print a file. 
Parameters 

f File name with fully qualified path; 

Char string 

Example 

Print the file Screenplay.txt from the disc, 
ddir = InterAc tual. DiscDirectory; 
InterActual. Print (ddir + "/EXTRAS/" + 
"screenplay.txt") ; 
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Media Supported 



DVD Video 


DVD 
Audio 


CD Audio 


X 


X 


X 



Return Values 



Numbe 
r 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAllowed 


Operation not allowed by current 
UOP fields 


-3 


NotSupported 


File type or feature not 
supported at this time 


-4 


FileNotFound 


File not found 


-7 


MemoryErr 


Not enough memory for operation 



C.1.24 

InterActual .PlayPeriodlnTitleAutoStop ( t, sh, sm, ss, sf , eh, em, es, ef ) 

Summary 

This command is similar to PlayTimeAutoStop however it 
supports the use of frames versus milliseconds (as in 
hh:mm:ss:ff) . It starts playback in the specified 
title number (t) at the specified start time in hours 
(sh) , minutes (sm) , seconds (ss) and frames (sf ) and 
ends at the specified end time (using the same 
variables for hours, minutes, seconds and frames: eh, 
em, es, ef ) . For DVD-Audio, the first parameter 
represents the title group number (t) . 
Parameters 

t DVD-Video: Title number ranging from 1-99 

DVD-Audio: Title group number ranging from 
1-9 

CD-Audio: Track number ranging from 0-99 
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where 

if t = 0 then h, m, s are relative to 
the 

start of the CD -Audio, 
else t is the track number and 
the h, m, s are relative to that track 
Signed 1 byte integer 
sh Start hour where h can range from 00-23; 

Signed 1 byte integer 
sm Start minutes where m can range from 00 - 

59; 

Signed 1 byte integer 
ss Start seconds where s can range from 00 - 

59; 

Signed 1 byte integer 
sf Start frames where x can range from 0-30 

to accommodate either 25 or 30 frames per 
second. 

Signed 1 byte integer 

End hour where h can range from 00 - 23; 

Signed 1 byte integer 
em End minutes where m can range from 00 - 59; 

Signed 1 byte integer 
es End seconds where s can range from 00 - 59; 

Signed 1 byte integer 
ef End frames where x can range from 0 - 30 to 

accommodate either 25 or 30 frames per 

second* 

Signed 1 byte integer 

Examples 

Start playing from the specified time position of the 
current title to the end position. For example to 
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play title 2 from 1 hour, 10 minutes, 30 seconds, 
frame 7 in the title to frame 20: 

InterActual . PlayPeriodlnTi tleAutoStop (2,1,10,30/7,1 
,10,30,20) 

Requires 

DVD-Video: This command requires that the UOP0 
operation be permitted. 
Media Supported 



DVD Video 


DVD 
Audio 


CD Audio 


X 


X 


X 



Return Values 



Numbe 
r 


Name 


Description 


0 


OK 


Successful 


-1 


GeneralError 


Unknown error condition 


-2 


UOPNotAl lowed 


Operation not allowed by current 
UOP fields 


-3 


NotSupported 


File type or feature not 
supported at this time 


-5 


NoDisc 


Attempt to play with no disc 


-6 


ParmRangeErr 


Parameter out of range or invalid 
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C.2 Properties 



InterActual . CurrentMenuLanguage 

Summary 

Returns the current menu language. 
Return Value 

char Unsigned 2 byte char as defined in 

ISO- 63 9, See the language codes 
section in the appendix. 

Example 

Query the current menu language. 
MyLanguage s InterActual .CurrentMenuLanguage 

Media Supported 



DVD 

Video 


DVD 
Audio 


CD 

Audio 


X 


X 





C . 2 . 2 InterActual . TotalNumMenuLanguage 

Summary 

Returns the total number of menu languages available. 
Return Value 

JavaScript Signed 1 byte integer ranging from 

Number 0 - 99; 0 means none available 

Example 

Query the number of menu languages available. 
NumberMenuLang = InterActual •TotalNumMenuLanguage 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 


X 


X 





C . 2 . 3 InterActual . ParentalCountry 

Summary 
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Returns the current parental country level. 
Return Value 

Char Country code to be set according to 

the Alpha- 2 code defined in IS03166; 
unsigned 2 byte character string 

Example 

Query the parental country level. 
PCountry = InterActual.ParentalCountry 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 


X 







4 InterActual . CCTextStatus 

Summary 

Returns the status of closed captioning. 
Return Value 

JavaScript Returns 0 if CC is disabled, or 1 

Number if enable; 

Signed 1 byte integer 

Example 

Get the status of closed captioning: 
CCstatus * InterActual, CCTextStatus 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 


X 


X 





5 InterActual . CCText 

Summary 

Returns the Closed Caption text string from the 
current Group of Pictures (GOP) . 
Return Value 
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Character Maximum of 256 characters of text 

string 
Example 

Get the Closed Caption text: 
CCstring s InterActual . CCText 
Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 


X 


X 





C ♦ 2 . 6 InterActual . MaxSlow 

Summary 

Returns the maximum number of slow speeds supported. 
Return Value 

JavaScript Signed 1 byte integer Number of 

Number slow speeds ranging from 0-99 

Example 

Get the total number of slow speeds supported, 
x = InterActual. MaxSlow 

Notes 

This will return zero (0) if there are no slow speeds 
supported. 
Media Supported 



DVD 
Video 


DVD 
Audio 


CD 

Audio 


X 


X 





C . 2 . 7 InterActual .MaxSlowReverse 

Summary 

Returns the maximum number of reverse slow speeds 
supported. 
Return Value 

JavaScript Signed 1 byte integer Number of 
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Number reverse slow speeds ranging from 0 

- 99 

Example 

Get the total number of reverse slow speeds supported, 
x = Inter Ac tual .MaxSlowRe verse 

Notes 

This will return zero (0) if there are no reverse slow 
speeds supported. 
Media Supported 



DVD 

Video 


DVD 
Audio 


CD 

Audio 


X 


X 





8 InterActual . DiscRegion 

Summary 

Returns the region code for the DVD. 
Return Value 

JavaScript Signed 1 byte integer 



0x00 




unknown 0x01 = Region 1 


0x02 




Region 2 


0x04 




Region 3 


0x08 




Region 4 


0x10 




Region 5 


0x20 




Region 6 


0x40 




Reserved 


0x80 




Reserved for sign 



Example 

Query the region code for the disc. Multi-region discs 
will have multiple bits on. 
regionCode = InterActual .DiscRegion 
Media Supported 



DVD 


DVD 


CD 


Video 


Audio 


Audio 
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9 InterActual •DiscDirectory 

Summary 

Returns the full path name corresponding to the 
location of the currently inserted disc's root 
directory (computer only) , Hence, for a PC, we would 
expect W D:/" in most cases if the DVD-ROM is on drive 
D. 

Return Value 

Character Character string containing 

string pathname using V" for directory 

separators on all platforms; 
maximum of 256 (computer only) 

Example 

Query for the current drive/path that contains the 
disc: 

discPath = InterActual •DiscDirectory 

Notes 

Some platforms may be case sensitive in the file and 
directory names. If this property is parsed and 
manipulated, the programmer should adhere to the 
specific platform standards. 
Media Supported 



DVD Video 


DVD Audio 


CD Audio 


X 


X 


X 



. 10 InterActual . LocalDirectory 

Summary 

Returns full path of the location corresponding to the 
local InterActual player (computer only) . On a PC, we 
would expect to see "C: /Program 
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Files/ InterActual/lnterActual Player/" if it is 
installed on drive C. 
Return Value 

Character Character string containing 

string pathname using u /" for directory 

separators on all platforms; 
maximum of 256 (computer only) 
This will be NULL ("") if there is 
no computer application. 

Example 

Query for the local directory information: 
in3talledPath = InterActual. LocalDirectory 

Notes 

This value will be NULL if there is no computer 
application and only an InterActual object embedded 
within a web page. 

Some platforms may be case sensitive in the file and 
directory names. If this property is parsed and 
manipulated, the programmer should adhere to the 
specific platform standards. 
Media Supported 



DVD Video 


DVD Audio 


CD Audio 


X 


X 


X 



.11 InterActual . CurrentZoomX 

Summary 

Returns the current zoom x value 
Return Value 

JavaScript Value of x for zoom; unsigned 4 

Number byte (32 -bit) value 

Example 

Get the x value for the current zoom. . 
x = Inter Actual. CurrentZoomX 
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Media Supported 



DVD Video 


DVD 
Audio 


CD Audio 


X 


X 





12 InterActual . CurrentZoomY 

Summary 

Returns the current zoom y value 
Return Value 

JavaScript Value of y for zoom; unsigned 4 

Number byte (32 -bit) value 

Example 

Get the y value for the current zoom. . 
y = InterActual. CurrentZoomY 

Media Supported 



DVD Video 


DVD 
Audio 


CD Audio 


X 


X 





13 Inter Actual. Cur r en tPanX 

Summary 

Returns the current Pan x value. 
Return Value 

JavaScript Value of x for pan; unsigned 4 

Number byte (32 -bit) value 

Example 

Get the x value for the current pan. 
x = InterActual .Cur rent PanX 

Media Supported 



DVD Video 


DVD 
Audio 


CD Audio 


X 


X 
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C.2.14 InterActual.CurrentPanY 

Summary 

Returns the current Pan y value. 
Return Value 

JavaScript Value of y for pan; unsigned 4 

Number byte (32 -bit) value 

Example 

Get the y value for the current pan. 
y s InterActual.CurrentPanY 

Media Supported 



DVD Video 


DVD 
Audio 


CD Audio 


X 


X 





C.2.15 InterActual.MixVolume 

Summary 

Returns the current primary audio stream volume level 
as a percentage of full volume. 
Return Value 

JavaScript Percentage for audio stream 

Number volume . 

Signed 1 byte integer ranging from 
0 -100 

Example 

Get the current mix volume level . 
MixVolumej>ercentage = InterActual.MixVolume 

Media Supported 



DVD Video 


DVD 
Audio 


CD Audio 


X 


X 


X 



C . 2 . 16 InterActual . FramesPerSecond 

Summary 
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Returns the video frame rate for the current DVD title 
correlating to NTSC/SECAM or PAL television frame 
rates . 
Return Value 

JavaScript 25: frames per second (NTSC/SECAM) 

Number 30: frames per second (PAL) 

Signed 1 byte integer 

Example 

Get the current frames per seconds setting. 
TV_TYPE « InterActual.FramesPerSecond 

Media Supported 



DVD Video 


DVD 
Audio 


CD Audio 


X 


X 


X 
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C.3 Events 

Sample private advanced event functions 

C.3.1 Mouse Event 

Summary 

Called when the user clicks either the left or right 
mouse button based on the video coordinates. Returns 
mouse button number and coordinates. 
Return parameters 

mouseButto Button, 0=lef t mouse button, l=right 

n mouse button 

x X coordinate of click, signed 2 byte 

integer ranging from 0-719 

y Y coordinate of click, signed 2 byte 

integer ranging from 0 - 479 or 575 
depending on NTSC versus PAL 

Example 

Trigger an event when user clicks the mouse: 
< SCRIPT LANGUAGE^" JavaScript" > 
function MouseEvent (mouseButton, x, y) 
if (mouseButton == 0) { 

// Trigger event based on left mouse click 

} 

</SCRIPT> 

Notes 

The coordinate system for both PC and Macintosh will 
be defined with top left as 0,0 with x moving from top 
left to top right and y moving from top left to bottom 
left. 
Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 


X 
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2 Menu Button Event 

Summary 

Called when a button is highlighted. Returns the 
button number. 
Return parameters 

menuButto Button number, signed 1 byte integer 
n ranging from 1-36 

Example 

Trigger an event based on button event . 
<SCRIPT LANGUAGE = "JavaScript"> 
function MenuButtonEvent (menuButton) 
if (menuButton == 1) { 

// Trigger event based on button highlight 

} 

</SCRIPT> 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 





.3 Karaoke Event 

Summary 

Called when a Karaoke event changes. 
Return parameters 

karaokeNu Karaoke event, where it will return a 
m signed 1 byte integer as follows 

1: if karaoke track has begun playing 
0: if just finished 

Example 

Set the KaraokeEvent and test when it triggers: 
<SCRIPT LANGUAGE^ " JavaScript " > 
function KaraokeEvent (karaokeNum) 
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if (karaokeNum == 1) { 

// do stuff while it is playing. 

} 

</SCRIPT> 

5 Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 





C.3.4 Still Event 

Summary 

Called when Still state changes, e.g. when change of 
state from StillOn to StillOff or vice versa. 
Return parameters 

state New state, signed 1 byte integer 

ranging from 0-1 
0: StillOff now 
1: StillOn now 

Example 

Trigger an event when Still state changes: 
<SCRIPT LANGUAGE= "JavaScript" > 
function StillEvent (state) 
if (state == 1) 

{ 

// Do something while still is up on screen 

} 

</SCRIPT> 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 


X 





C.3,5 CC Text Event 
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Summary 

Called when the CC text changes for a new GOP . 
Return parameters 
None 

Example 

Trigger an event when the CC Text changes: 
<SCRIPT LANGUAGE = " JavaScript " > 
function CCTextEvent () 
current = Inter Actual .CCText 
if (current • length) 

{ 

// Display CC text somewhere 

} 

</SCRIPT> 

Media Supported 



DVD 


DVD 




CD Audio 


Video 


Audio 






X 


X 




Fullscreen 


Event 


(PC 


only) 



Summary 

Called when video transitions from full screen to 
windowed mode and vice versa. 
Return parameters 

transitio 1: video playback transitions from 
n window to full screen mode 0: video 

playback transitions from full screen 
to window mode Signed 1 byte integer 

Notes 

This event is also thrown when playback is stopped 
(returning a w 0") . It is expected that the event 
monitor code will call HideControls () upon receiving 
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return of "0" and will call ShowControls () upon 
receiving a return of "1". 
Example 

Trigger an event when changing from full screen 
to windowed mode: 
<SCRIPT LANGUAGE= " JavaScript" > 
function FS2Win(t) 
if (t == 0) 

{ 

// Trigger here 

} 

</SCRIPT> 

Media Supported 



DVD 
Video 


DVD 
Audio 


CD Audio 


X 
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